Monitor with Operational Metrics

You can enable metrics to monitor your services running in MK.IO.

The metrics you can scrape from your MK.IO can be used to monitor workflow services, including:

• Live events (input & output bitrate monitoring)
• Streaming endpoints (error rate, bitrate & latency)
• On-demand encode jobs (count of successful & unsuccessful completed jobs)

Metrics are enabled per subscription. Once enabled, you will have access to metrics for all services within your subscription.

Enable metrics on your MK.IO subscription

To enable metrics on your MK.IO subscription:

1. Log in to MK.IO (opens in a new tab) and select a subscription.

2. From the left-hand side menu, navigate to Usage and Metrics.

3. Enable the metrics using the switch at the top right of the page.

Once metrics are activated, MK.IO will provide you with a URL, a Username and a Password. This information can be used by your monitoring infrastructure to scrape the metrics from MK.IO.

Scrape metrics into Grafana Cloud

Once metrics are enabled in MK.IO, you can obtain a real-time stream of metrics by scraping the “federate” endpoint returned in the enable API call. Metrics are updated every 30s.

To scrape metrics into your Grafana Cloud account:

1. Log in to Grafana Cloud. Create an account if you don't already have one.
2. From the left-hand menu, go to Connections and click Add new connection.
3. In the search bar, type Metrics Endpoint, then open the Metrics Endpoint integration.
4. Click Add new scrape job.

Configure the scrape job

Get the details below from the MK.IO portal and enter them into Grafana.

1. Name: Enter a name for your scrape job.
2. Scrape Job URL: Use the URL provided by MK.IO (the federate endpoint), for example https://<URL provided by MK.IO>.
3. Basic authentication: Enter the Username and Password provided by MK.IO.
4. Scrape interval: Set the interval to 30s or 1 minute. Use 30s if you need tighter real-time visibility; use 1 minute to reduce cost and data volume.
5. Test Connection to verify the endpoint is reachable.
6. Click Save Scrape Job.

View metrics

1. Import the MK.IO dashboard (opens in a new tab) into your Grafana Cloud account, or
2. Open Explore and search for metrics starting with mk\_.

For a full list of MK.IO services and supported metrics, see the Metrics and labels section below.

Metrics and labels

Each service in MK.IO provides different sets of metrics and labels.

The "Labels" column shows labels specific to each metric. Additionally, there are labels that are common to all customer metrics: region, project_name, project_id.