Query metrics in Grafana with an agent

MOI agents use connectors to work with external tools. An agent can look up issues in GitHub or check monitoring metrics in Grafana. This tutorial shows you how to connect Grafana to an agent and ask how many instances of a service Prometheus is currently scraping successfully.

Before you begin

  • A MOI workspace where you can configure connectors and edit agents.

  • A Grafana instance reachable from MOI, with a Prometheus data source that contains metrics for your service.

1. Configure Grafana in MOI

  1. In Grafana, go to Administration → Users and access → Service accounts. Select Add service account and grant the account permission to query the target data source.

  2. Open the service account, select Add service account token, and set a name and expiration date. Select Generate token and copy the value. See Grafana service accounts.

  3. In MOI, go to Agent → Resource Center → Connectors · Channels · Tools → Connectors and search for Grafana. Select Configure or Manage to open the instance list, then select New. If you already have an instance you can use, go to step 2.

Field

Value

Tool Instance Name

A name such as Service Monitoring Grafana.

Grafana URL

The base URL, such as https://grafana.example.com. Omit dashboard paths, /api, and query parameters.

Service Account Token

The token copied from Grafana, without the Bearer prefix.

Grafana connection form in MOI

Select Save, then Test Connection in the instance list. Once the test passes, you can bind the instance to an agent. For more on the connection fields, see Configure Grafana.

2. Bind Grafana to the agent

Open the target agent’s details. Next to Bound Tools, select Add. Choose Grafana and the instance you configured, then save. Check that Grafana appears under Bound Tools.

3. Query a metric in chat

Return to the agent list and select Use for that agent. In the message below, replace demo-api with your Prometheus job name, then send it.

Use Grafana to check how many demo-api instances are currently being scraped successfully.

MOI agent chat showing a Grafana query and sample result

Expand Execution process in the conversation and check that the Grafana Prometheus query (moi_grafana_prometheus_query) completed. In the example, Prometheus successfully scraped two targets. If the query returns no samples, check the data source and the service’s job label. See Prometheus jobs and instances.

Last updated on