MK.IO Metrics Monitor

Welcome to MK.IO

High-performance, API-driven video infrastructure for modern video applications

For more about MK.IO and to create an account, consult our customer documentation.

This dashboard showcases metrics you can scrape from your MK.IO services. They can be used to monitor, in realtime, MK.IO workflow services such as:

• Streaming Endpoints (Error rate, Bitrate & Latency)
• OD Encode jobs (Count of successful & unsuccessful completed jobs)
• Live events

Note: Metrics publishing is a chargeable service and is not enabled by default.

Enable metrics on your MK.IO subscription

• Consult our API documentation on how to enable metrics publishing on your subscription. (Note this is a chargeable service. See MK.IO pricing for all our pricing information.)
• The MK.IO api endpoint is PATCH /api/v1/projects/{project_name}/metricsEndpoint
• This will enable metrics and return the url of your public metrics endpoint and BasicAuth username and password. This endpoint is a prometheus-compatible “federate” endpoint.
• To receive the metrics, you will need to scrape this endpoint using a scrape mechanism of your choice.

Scrape metrics into Grafana Cloud

Once metrics are enabled in MK.IO, you can obtain a realtime 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:

• If you do not already have a Grafana Cloud account, you can create a free account on grafana.com. The free account is free-forever for up to 10,000 metrics series. As a guide, a single streaming endpoint in mkio will be less than 500 series.
• create a “Metrics Endpoint” integration in Grafana Cloud. See the Metrics Endpoint documentation in Grafana Cloud.
• the “Scrape Job URL” should be set to:

Copy

https://<URL returned in mk.io api call>/federate?match=%7Bregion=%22<your subscription region>%22%7D

where «your subscription region» should be set to one of: eastus, westus, westus2, centralus, francecentral, uksouth, westeurope, japanwest, japaneast depending on the region of your subscription.

• Use Basic Auth, with Username and Password set to the credentials returned in the mk.io api enable call.
• Normally, set the scrape interval to 1minute as a balance between your cost in Grafana cloud and timely data visibility.
• Import this dashboard into your Grafana Cloud account, or simply use the “Explore” tab to investigate metrics. All MK.IO metrics begin with “mk_”.