> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myrmex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Grafana

> Conecte o Grafana ao Myrmex pela sua API — crie um token de conta de serviço e adicione a integração.

import { Note, Steps, Step, CardGroup, Card, Tip } from '@mintlify/components';

Conecte sua instância do **Grafana** para que o Myrmex possa verificar sua saúde, inspecionar dashboards e ler métricas. O Myrmex acessa o Grafana pela sua **API HTTP** através de um [Collector](/pt/documentation/agent-endpoint-security/collector-mode) na sua rede. Toda requisição é executada **ao vivo, sob demanda** — o Myrmex retorna apenas o que você pedir e não copia nem armazena nada do Grafana do seu lado. As credenciais são resolvidas do seu lado e nunca passam pelo modelo.

## O Que o Myrmex Pode Fazer

<CardGroup cols={2}>
  <Card title="Verificar a saúde" icon="heart-pulse">
    Leia a saúde e o status do Grafana para confirmar que a instância está no ar.
  </Card>

  <Card title="Inspecionar dashboards" icon="table-columns">
    Liste e inspecione dashboards ao vivo para ver o que está sendo monitorado.
  </Card>

  <Card title="Ler métricas" icon="chart-line">
    Puxe métricas pela API sob demanda e retorne apenas o que você pediu.
  </Card>

  <Card title="Revisar fontes de dados" icon="database">
    Liste as fontes de dados configuradas para entender de onde vêm os dados.
  </Card>
</CardGroup>

## Antes de Começar

* Um **Collector** que consiga alcançar o Grafana por HTTP ou HTTPS (porta padrão `3000`). Veja [Modo Collector](/pt/documentation/agent-endpoint-security/collector-mode).
* Uma **conta de serviço** (ou chave de API) com pelo menos a função **Viewer**.

## Passo 1 — Crie a Credencial no Grafana

<Steps>
  <Step title="Crie uma conta de serviço">
    No Grafana, vá em **Administration → Users and access → Service accounts** e adicione uma conta de serviço com a função **Viewer** — suficiente para saúde, dashboards e métricas.
  </Step>

  <Step title="Adicione um token">
    Na conta de serviço, clique em **Add service account token**, defina uma expiração opcional e copie o token. O Myrmex o envia como Bearer token.
  </Step>
</Steps>

<Tip>
  Use uma conta de serviço com a função Viewer para monitoramento somente leitura. Conceda uma função mais alta apenas se, mais tarde, precisar que o Myrmex altere o Grafana.
</Tip>

## Passo 2 — Adicione a Integração no Myrmex

No **Directory**, escolha **Add Integration → Grafana** e preencha:

| Field                     | Descrição                                                                                      |
| ------------------------- | ---------------------------------------------------------------------------------------------- |
| **Name**                  | Um nome único para esta instância do Grafana.                                                  |
| **Description**           | Nota opcional para identificar a instância.                                                    |
| **API Token**             | O token de conta de serviço criado no Passo 1.                                                 |
| **URL**                   | Host ou IP do Grafana que o Collector consegue alcançar.                                       |
| **Protocol**              | `http` ou `https`.                                                                             |
| **Port**                  | A porta do Grafana (padrão `3000`).                                                            |
| **Collector**             | O [Collector](/pt/documentation/agent-endpoint-security/collector-mode) que alcança o Grafana. |
| **Authentication Method** | `bearer` (o token de conta de serviço).                                                        |

## Conectar

Clique em **Connect** para validar a conexão com a API e concluir. O Grafana então aparece em **Environment → Integrations**, e você pode perguntar sobre ele no Workspace ou por meio do [agente Integration Specialist](/pt/documentation/multi-agent-system/integration-specialist-agent).

<Note>
  Atrás de um proxy reverso, o Grafana pode ser servido na `443` sob um sub-caminho. Aponte a URL e a Port para o endereço que o Collector realmente consegue alcançar.
</Note>