Monitor metrics for multicast

This page describes the metrics that are available to multicast administrators for monitoring multicast groups.

You can use these metrics to help you understand performance and actions in a multicast group, such as how many multicast consumers are joining, leaving, or are in a group.

The metrics on this page are available in multicast administrator projects that contain multicast domain and group range configurations. The metrics aren't available in multicast consumer projects, such as in the Network Connectivity Center (NCC) star topology that supports multicast consumers in separate projects.

About Cloud Monitoring metrics for multicast

Google Cloud reports monitoring metrics for multicast to Cloud Monitoring.

Data is reported in one-minute intervals to Monitoring and is retained in Monitoring for six weeks.

The following section describes the corresponding monitored resource type and the available metrics.

Multicast metrics reference

This section describes the available metric types for multicast that are reported to Monitoring. These metrics are reported for the MulticastGroup monitored resource type.

For a list of other metric types in Google Cloud, see Google Cloud metrics.

The "metric type" strings in this table must be prefixed with networkservices.googleapis.com/. That prefix has been omitted from the entries in the table. When querying a label, use the metric.labels. prefix; for example, metric.labels.LABEL="VALUE".

Metric type Launch stage (Resource hierarchy levels)
Display name
Kind, Type, Unit
Monitored resources		 Description
Labels
multicast/admin/group_control_messages GA  (project)
The number of control messages received for the specific multicast group
DELTA, INT64, 1
networkservices.googleapis.com/MulticastGroup 		The number of multicast group control messages. Sampled every 60 seconds. After sampling, data is not visible for up to 180 seconds.
consumer_project_number: Consumer project ID (numeric string).
consumer_location: The consumer's zone.
message_type: The type of the control message. (e.g. "IGMP_CONSUMER_JOINED")
result: "UNKNOWN" for all but "IGMP_JOIN_REJECTED" messages. For "IGMP_JOIN_REJECTED", contains the rejection reason.
multicast/admin/number_of_active_consumers GA  (project)
The number of consumers currently subscribed to the specific multicast group
GAUGE, INT64, 1
networkservices.googleapis.com/MulticastGroup 		The number of active consumers per multicast group. Sampled every 60 seconds. After sampling, data is not visible for up to 210 seconds.
consumer_project_number: Consumer project ID (numeric string).
consumer_location: The consumer's zone.

Use Cloud Monitoring metrics

The following sections describe how to use Cloud Monitoring metrics.

In addition to the predefined dashboards in Monitoring, you can create custom dashboards, set up alerts, and query the metrics through the Monitoring API.

View metrics in Monitoring

Console

To view the metrics for a monitored resource by using the Metrics Explorer, do the following:

  1. In the Google Cloud console, go to the  Metrics explorer page:

    Go to Metrics explorer

    If you use the search bar to find this page, then select the result whose subheading is Monitoring.

  2. In the toolbar of the Google Cloud console, select your Google Cloud project. For App Hub configurations, select the App Hub host project or the app-enabled folder's management project.
  3. In the Metric element, expand the Select a metric menu, enter Multicast Group in the filter bar, and then use the submenus to select a specific resource type and metric:
    1. In the Active resources menu, select Multicast Group.
    2. To select a metric, use the Active metric categories and Active metrics menus.
    3. Click Apply.

  4. To add filters, which remove time series from the query results, use the Filter element.

  5. To combine time series, use the menus on the Aggregation element. For example, to display the CPU utilization for your VMs, based on their zone, set the first menu to Mean and the second menu to zone.

    All time series are displayed when the first menu of the Aggregation element is set to Unaggregated. The default settings for the Aggregation element are determined by the metric type you selected.

  6. For quota and other metrics that report one sample per day, do the following:
    1. In the Display pane, set the Widget type to Stacked bar chart.
    2. Set the time period to at least one week.

Define alerting policies

Console

You can create alerting policies to monitor the values of metrics and to notify you when those metrics violate a condition.

  1. In the Google Cloud console, go to the  Alerting page:

    Go to Alerting

    If you use the search bar to find this page, then select the result whose subheading is Monitoring.

  2. If you haven't created your notification channels and if you want to be notified, then click Edit Notification Channels and add your notification channels. Return to the Alerting page after you add your channels.
  3. From the Alerting page, select Create policy.
  4. To select the metric, expand the Select a metric menu and then do the following:
    1. To limit the menu to relevant entries, enter Multicast Group into the filter bar. If there are no results after you filter the menu, then disable the Show only active resources & metrics toggle.
    2. For the Resource type, select Multicast Group.
    3. Select a Metric category and a Metric, and then select Apply.
  5. Click Next.
  6. The settings in the Configure alert trigger page determine when the alert is triggered. Select a condition type and, if necessary, specify a threshold. For more information, see Create metric-threshold alerting policies.
  7. Click Next.
  8. Optional: To add notifications to your alerting policy, click Notification channels. In the dialog, select one or more notification channels from the menu, and then click OK.
  9. Optional: Update the Incident autoclose duration. This field determines when Monitoring closes incidents in the absence of metric data.
  10. Optional: Click Documentation, and then add any information that you want included in a notification message.
  11. Click Alert name and enter a name for the alerting policy.
  12. Click Create Policy.
For more information, see Alerting overview.

Create custom Monitoring dashboards

Console

  1. In the Google Cloud console, go to the  Dashboards page:

    Go to Dashboards

    If you use the search bar to find this page, then select the result whose subheading is Monitoring.

  2. Click Create dashboard
  3. Optional: Update the dashboard title with a descriptive name for your dashboard.
  4. Click Add Widget and then select Metric.
  5. Expand the Metric menu, enter Multicast Group in the filter bar, and then use the submenus to select a specific resource type and metric:
    1. In the Active resources menu, select Multicast Group.
    2. In the Active metric categories menu, select Multicast.
    3. In the Active metrics menu, select the metric that you want to view.
    4. Click Apply.
  6. Combine time series:
    • To display every time series, in the Aggregation element, ensure the first menu is set to Unaggregated and the second menu is set to None.

    • To combine time series, in the Aggregation element, use the first menu to select a function and the second menu to select the labels. If the second menu is set to None, then the chart displays one time series.

      For example, to display the average value of time series after grouping by zone, set the first menu to Mean and the second to zone.

    For information about combining time series, see Choose how to display charted data.

  7. For each additional widget that you want to add to your dashboard, click Add widget, complete the dialog, and then select Apply.

    For more information about adding widgets, see the following pages:

What's next