---
name: metrics-router-platform_metrics
title: Platform metrics for IBM Cloud Metrics Routing
description: You can use the IBM Cloud® Monitoring service to monitor platform metrics that are exposed by IBM Cloud Metrics Routing. For example, you can use it to monitor how IBM Cloud Metrics Routing is routing metrics in each region where you operate.
last-updated: 2025-07-31
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/metrics-router?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Platform metrics for IBM Cloud Metrics Routing
{: #platform-metrics}

You can use the IBM Cloud® Monitoring service to monitor platform metrics that are exposed by IBM Cloud Metrics Routing. For example, you can use it to monitor how IBM Cloud Metrics Routing is routing metrics in each region where you operate.
{: shortdesc}

Platform metrics are metrics that are exposed by enabled-monitoring services and the platform in IBM Cloud. You can use them to find and take action on configuration problems and possible outages.

IBM Cloud Monitoring is a cloud-native, and container-intelligence management system that you can include as part of your IBM Cloud architecture. You can use it to gain operational visibility into the performance and health of your applications, services, and platforms. It offers administrators, DevOps teams, and developers full stack telemetry with advanced features to monitor and troubleshoot, define alerts, and design custom dashboards. For more information, see [Getting started with Monitoring](https://cloud.ibm.com/docs/monitoring?topic=monitoring-getting-started&format=markdown).

## Collecting platform metrics
{: #platform-metrics-collect}

The IBM Cloud Metrics Routing generates metrics automatically in the IBM Cloud account.

To collect platform metrics in an IBM Cloud account, choose 1 of the following options:

- Configure the Monitoring service in the IBM Cloud account

    You can use Monitoring, an IAM enabled service, to collect metrics through instances that you provision in each IBM Cloud region where you operate and that you enable to collect platform metrics. For more information on how to enable platform metrics, see [Enabling platform metrics](https://cloud.ibm.com/docs/monitoring?topic=monitoring-platform_metrics_enabling&format=markdown#platform_metrics_enabling).

    You can configure 1 instance only of the IBM Cloud Monitoring service per region to collect platform metrics in that location. For more information about supported locations, see [Locations supported by the Monitoring service](https://cloud.ibm.com/docs/monitoring?topic=monitoring-regions&format=markdown).

    In a region, before you configure a Monitoring instance to collect platform metrics, check with the account or service administrator if another Monitoring instance has already been configured. You may not have permissions to see all Monitoring instances in the region.
    {: note}

- Configure IBM Cloud Metrics Routing in the IBM Cloud account

    You can use IBM Cloud Metrics Routing, a platform service, to collect and route metrics at the account-level by configuring targets and routes that define where and how metrics are routed in the account. Supported targets are Monitoring instances.

    IBM Cloud Metrics Routing routes metrics based on filtering conditions that are defined by 1 or more of the following values from the incoming service data. Presently, we allow the following operands: location, service name, service instance ID, resource type, and resource.

    You can define a target, the resource where metrics are routed to, in any IBM Cloud Metrics Routing supported region. However, the target resource can be located in any region where that type of target is supported, in the same account or in a different account. You can define rules to determine where metrics are to be routed by configuring 1 or more routes in the account. For more information about how to configure IBM Cloud Metrics Routing, see [Getting started with IBM Cloud Metrics Routing](https://cloud.ibm.com/docs/metrics-router?topic=metrics-router-getting-started&format=markdown).

    IBM Cloud Metrics Routing can only route metrics that are generated in [supported regions](https://cloud.ibm.com/docs/metrics-router?topic=metrics-router-regions&format=markdown). Other regions, where IBM Cloud Metrics Routing is not available, continue to collect and manage metrics by using the Monitoring service.
    {: important}


You can collect metrics that are generated by IBM Cloud Metrics Routing by using any of the following methods:

* Configuring IBM Cloud Metrics Routing.

* Configuring the Monitoring service.


## Locations where platform metrics are generated
{: #mon-locations}

IBM Cloud Activity Tracker Event Routing sends metrics in the regions that are indicated in the following table.



| Dallas (`us-south`) | Washington (`us-east`)  | Toronto (`ca-tor`) | Montreal (`ca-mon`) | Sao Paulo (`br-sao`) |
|---------------------|-------------------------|-------------------|-------------------|----------------------|
| [Yes]{: tag-green} | [Yes]{: tag-green} | [Yes]{: tag-green} | [Yes]{: tag-green} | [Yes]{: tag-green} |
{: caption="Regions where platform metrics are sent in Americas locations" caption-side="top"}
{: #mon-table-1}
{: tab-title="Americas"}
{: tab-group="mon"}
{: class="simple-tab-table"}
{: row-headers}


| Tokyo (`jp-tok`)    | Sydney (`au-syd`) |  Osaka (`jp-osa`) | Chennai (`in-che`) |
|---------------------|------------------|------------------|--------------------|
| [Yes]{: tag-green} | [Yes]{: tag-green} | [Yes]{: tag-green} | [Yes]{: tag-green} |
{: caption="Regions where platform metrics are sent in Asia Pacific locations" caption-side="top"}
{: #mon-table-2}
{: tab-title="Asia Pacific"}
{: tab-group="mon"}
{: class="simple-tab-table"}
{: row-headers}

| Frankfurt (`eu-de`)  | London (`eu-gb`) | Madrid (`eu-es`) |
|---------------------------------------------------------------|---------------------|------------------|
| [Yes]{: tag-green} | [Yes]{: tag-green} | [Yes]{: tag-green} |
{: caption="Regions where platform metrics are sent in Europe locations" caption-side="top"}
{: #mon-table-3}
{: tab-title="Europe"}
{: tab-group="mon"}
{: class="simple-tab-table"}
{: row-headers}


## Monitoring IBM Cloud Metrics Routing
{: #platform-metrics-view}

You monitor the health and status of IBM Cloud Metrics Routing by monitoring metrics through the Monitoring web UI.

- If you collect metrics through the Monitoring service, you must launch the Monitoring UI for the instance that is either enabled for platform metrics in the same region as your service instance or is configured as a Metrics Router target.

- If you collect and route metrics to 1 or more Monitoring instances by configuring IBM Cloud Metrics Routing in the account, you must launch the Monitoring UI for each instance that is configured and included in a routing rule.

In Monitoring, use the *IBM Cloud Metrics Routing Overview* predefined dashboard template to monitor IBM Cloud Metrics Routing in IBM Cloud.

To open the predefined IBM Cloud Metrics Routing template, complete the following steps from the Monitoring UI:

1. In the Monitoring UI, go to **Dashboards** > **Dashboard templates** > **IBM**.
2. Select **IBM Cloud Metrics Routing Overview**.

You cannot modify a dashboard template. However, you can copy the template and create a custom dashboard that you can then configure.
{: note}

Next, choose any of the following tasks to learn more about how to manage and work with platform metrics:

| Task | For more information |
|------|----------------------|
| Working with platform metrics | [link](https://cloud.ibm.com/docs/monitoring?topic=monitoring-platform_metrics_working&format=markdown) |
| Controlling what data is visible | [link](https://cloud.ibm.com/docs/monitoring?topic=monitoring-platform_metrics_working&format=markdown#global-attributes) |
| Monitoring metrics using dashboards | [link](https://cloud.ibm.com/docs/monitoring?topic=monitoring-platform_metrics_working&format=markdown#platform_metrics_working_dash) |
| Configuring an alert for a platform metric | [link](https://cloud.ibm.com/docs/monitoring?topic=monitoring-platform_metrics_working&format=markdown#platform_metrics_working_alert) |
| Controlling access by using teams | [link](https://cloud.ibm.com/docs/monitoring?topic=monitoring-platform_metrics_working&format=markdown#platform_metrics_working_team) |
{: caption="More information about Monitoring tasks" caption-side="bottom"}

## Metrics
{: #platform-metrics-details}

IBM Cloud Metrics Routing exposes the following metrics:

- [Successful data points](#platform-metrics-ibm-metrics-router-successful-data-points)
- [Target mode](#platform-metrics-ibm-metrics-router-target-mode)

### Total number of data points successfully sent to the storage target
{: #platform-metrics-ibm-metrics-router-successful-data-points}

Total number of data points that IBM Cloud Metrics Routing sent successfully to the destination target.

| Metadata         | Description |
|------------------|-------------|
| `Metric Name`    | `ibm_metrics_router_successful_data_points` |
| `Metric Type`    | `gauge` |
| `Value Type`     | `none` |
| `Segment By`     | `ibm_ctype`,`ibm_location`, `ibm_scope`, `ibm_service_name`, `ibm_resource_type`, `ibm_resource_name`, `ibm_resource`, `ibm_metrics_router_source_region`, `ibm_metrics_router_target_type` |
| `Frequency`      | `60 seconds`  |
{: caption="Total number of metrics successfully sent to the storage target" caption-side="top"}


### The current target mode
{: #platform-metrics-ibm-metrics-router-target-mode}

The current mode for IBM Cloud Metrics Routing targets. There are two possible values for the metric:
- `1` is for valid targets.
- `0` is for misconfigured targets.

It is your responsibility to resolve misconfigured targets, at least one of the following needs to be fixed:
1. You must have the correct service-to-service authorizations, see [Managing authorizations to grant access between services](https://cloud.ibm.com/docs/metrics-router?topic=metrics-router-iam-service-auth&interface=ui&format=markdown).
2. Your target destination must be a CRN for a Cloud instance that still exists.

| Metadata | Description |
|----------|-------------|
| `Metric Name`    | `ibm_metrics_router_target_mode`|
| `Metric Type`    | `gauge` |
| `Value Type`     | `none` |
| `Segment By`     | `ibm_ctype`,`ibm_location`, `ibm_scope`, `ibm_service_name`, `ibm_resource_type`, `ibm_resource_name`, `ibm_resource`, `ibm_metrics_router_target_type`  |
| `Frequency`      | `60 seconds`  |
{: caption="The current target mode" caption-side="top"}


### Global Attributes
{: #platform-metrics-global-attributes}

The following attributes are available for all metrics.

| Attribute        | Attribute Name            | Attribute Description | Valid values |
|------------------|---------------------------|-----------------------|--------------|
| `Cloud Type`     | `ibm_ctype`               | The cloud type can be `public`, `dedicated`, or `local`.                               | Valid value is `public`.|
| `Location`       | `ibm_location`            | The location of the monitored resource, which can be a region, data center, or global. | [Valid regions](https://cloud.ibm.com/docs/metrics-router?topic=metrics-router-regions&format=markdown). |
| `Resource`       | `ibm_resource`            | The resource that is measured by the service, which is typically an identifying name or GUID. | |
| `Resource Name`  | `ibm_resource_name`       | The name of the resource that is measured by the service. | |
| `Resource Type`  | `ibm_resource_type`       | The type of the resource that is measured by the service.                               | Valid value is `target`.|
| `Scope`          | `ibm_scope`               | The scope is the account where the metric is generated. | |
| `Service name`   | `ibm_service_name`        | The name of the service that is generating this metric.                                 | Valid value is `metrics-router`.|
{: caption="Global attributes" caption-side="top"}

### More attributes
{: #platform-metrics-additional-attributes}

The following attributes are available for one or more attributes described in the previous tables. See the individual metrics for options.

| Attribute        | Attribute Name            | Attribute Description  | Valid values |
|------------------|---------------------------|------------------------|--------------|
| `Target Type`    | `ibm_metrics_router_target_type` | The type of target. | Valid value is `sysdig-monitor`.|
| `Source Region`    | `ibm_metrics_router_source_region` | The region that sent the data points. | Valid value is any region from [Locations](https://cloud.ibm.com/docs/metrics-router?topic=metrics-router-regions&format=markdown). |
{: caption="Other attributes" caption-side="top"}



## Dashboards templates
{: #platform-metrics-dashboard-templates}

The following table lists the pre-defined dashboard templates that are available to monitor IBM Cloud Metrics Routing:

| Dashboard Name | Dashboard description |
|----------------|-----------------------|
| `Metrics Routing - Overview` | Use this dashboard to monitor IBM Cloud Metrics Routing data point processing and target modes. |
 {: caption="Pre-defined dashboard templates" caption-side="top"}