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.

👉

Metrics publishing is a chargeable service and is not enabled by default. Please refer to MK.IO Pricing for detailed information.

Enable metrics on your MK.IO subscription

To enable metrics on your MK.IO subscription:

  1. Log in to MK.IO 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.

👉

Alternatively, metrics can be enabled using API. Please refer to API documentation for instructions.

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. Create a Grafana Cloud account: If you do not already have an account, you can create a free one on grafana.com. The free plan allows up to 10,000 metric series forever. As a reference, a single streaming endpoint in MK.IO will typically use less than 500 series.
  2. Set up a Metrics Endpoint integration in Grafana Cloud:
    • Follow the Metrics Endpoint documentation in Grafana Cloud.
    • Scrape Job URL should be set to the following: https://<URL returned by MK.IO
    • Authentication: Use Basic Auth, setting the Username and Password to those returned by MK.IO.
    • Scrape Interval: Typically, set this to 1 minute to balance cost in Grafana cloud with timely data visibility.
  3. Import the dashboard or explore metrics: Import this dashboard into your Grafana Cloud account, or simply use the Explore tab to investigate metrics. All MK.IO metrics begin with mk\_.

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.


Services exposing: Subscription, Subscription quotas.

metricDescriptionTypeLabels
mk_upAlways present and equal to 1 when metrics are enabledGauge
mkio_api_assetfilters_totalTotal number of Asset Filters in the subscriptionGauge
mkio_api_assets_totalTotal number of Assets in the subscriptionGauge
mkio_api_contentkeypolicies_totalTotal number of Content Key Policies in the subscriptionGauge
mkio_api_devices_totalTotal number of Devices in the subscriptionGauge
mkio_api_filters_totalTotal number of Filters in the subscriptionGauge
mkio_api_jobs_totalTotal number of Jobs in the subscriptionGauge
mkio_api_jobs_running_totalTotal number of Jobs currently runningGauge
mkio_api_liveeventoutputs_totalTotal number of Live Event Outputs in the subscriptionGauge
mkio_api_liveevents_totalTotal number of Live Events in the subscriptionGauge
mkio_api_liveevents_running_totalTotal number of Live Events currently runningGauge
mkio_api_liveevents_stopped_totalTotal number of Live Events currently stoppedGauge
mkio_api_remoteconnections_totalTotal number of Remote Connections in the subscriptionGauge
mkio_api_storageaccounts_totalTotal number of Storage Accounts linked to the subscriptionGauge
mkio_api_streamingendpoints_totalTotal number of Streaming Endpoints in the subscriptionGauge
mkio_api_streamingendpoints_running_totalTotal number of Streaming Endpoints currently runningGauge
mkio_api_streamingendpoints_stopped_totalTotal number of Streaming Endpoints currently stoppedGauge
mkio_api_streamingendpoints_unit_totalTotal number of Streaming Endpoint Units allocatedGauge
mkio_api_streaminglocators_totalTotal number of Streaming Locators in the subscriptionGauge
mkio_api_streamingpolicies_totalTotal number of Streaming Policies in the subscriptionGauge
mkio_api_transforms_totalTotal number of Transforms in the subscriptionGauge
mkio_api_tunnels_totalTotal number of Tunnels in the subscriptionGauge