> ## 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

> Conecta Grafana a Myrmex mediante su API: crea un token de cuenta de servicio y agrega la integración.

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

Conecta tu instancia de **Grafana** para que Myrmex pueda verificar su estado, inspeccionar dashboards y leer métricas. Myrmex accede a Grafana mediante su **API HTTP** a través de un [Collector](/es/documentation/agent-endpoint-security/collector-mode) en tu red. Cada solicitud se ejecuta **en vivo, bajo demanda**: Myrmex devuelve únicamente lo que le pides y no copia ni almacena nada de Grafana de su lado. Las credenciales se resuelven de tu lado y nunca pasan por el modelo.

## Qué puede hacer Myrmex

<CardGroup cols={2}>
  <Card title="Verificar el estado" icon="heart-pulse">
    Lee el estado y la salud de Grafana para confirmar que la instancia está activa.
  </Card>

  <Card title="Inspeccionar dashboards" icon="table-columns">
    Enumera e inspecciona dashboards en vivo para ver qué se está monitoreando.
  </Card>

  <Card title="Leer métricas" icon="chart-line">
    Extrae métricas a través de la API bajo demanda y devuelve solo lo que pediste.
  </Card>

  <Card title="Revisar fuentes de datos" icon="database">
    Enumera las fuentes de datos configuradas para entender de dónde provienen los datos.
  </Card>
</CardGroup>

## Antes de comenzar

* Un **Collector** que pueda alcanzar Grafana por HTTP o HTTPS (puerto por defecto `3000`). Consulta el [modo Collector](/es/documentation/agent-endpoint-security/collector-mode).
* Una **cuenta de servicio** (o clave de API) con al menos el rol **Viewer**.

## Paso 1 — Crear la credencial en Grafana

<Steps>
  <Step title="Crea una cuenta de servicio">
    En Grafana, ve a **Administration → Users and access → Service accounts** y agrega una cuenta de servicio con el rol **Viewer**: suficiente para el estado, los dashboards y las métricas.
  </Step>

  <Step title="Agrega un token">
    En la cuenta de servicio, haz clic en **Add service account token**, establece una expiración opcional y copia el token. Myrmex lo envía como un token Bearer.
  </Step>
</Steps>

<Tip>
  Usa una cuenta de servicio con el rol Viewer para el monitoreo de solo lectura. Otorga un rol superior solo si más adelante necesitas que Myrmex modifique Grafana.
</Tip>

## Paso 2 — Agregar la integración en Myrmex

Desde el **Directory**, elige **Add Integration → Grafana** y luego completa:

| Field                     | Descripción                                                                                   |
| ------------------------- | --------------------------------------------------------------------------------------------- |
| **Name**                  | Un nombre único para esta instancia de Grafana.                                               |
| **Description**           | Nota opcional para identificar la instancia.                                                  |
| **API Token**             | El token de cuenta de servicio creado en el Paso 1.                                           |
| **URL**                   | Host o IP de Grafana que el Collector pueda alcanzar.                                         |
| **Protocol**              | `http` o `https`.                                                                             |
| **Port**                  | El puerto de Grafana (por defecto `3000`).                                                    |
| **Collector**             | El [Collector](/es/documentation/agent-endpoint-security/collector-mode) que alcanza Grafana. |
| **Authentication Method** | `bearer` (el token de cuenta de servicio).                                                    |

## Conectar

Haz clic en **Connect** para validar la conexión con la API y finalizar. Grafana aparecerá entonces en **Environment → Integrations**, y podrás preguntar sobre ella en el Workspace o a través del [Integration Specialist agent](/es/documentation/multi-agent-system/integration-specialist-agent).

<Note>
  Detrás de un proxy inverso, Grafana puede servirse en `443` bajo una subruta. Apunta la URL y el Port a la dirección que el Collector pueda alcanzar realmente.
</Note>