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

> Collega Grafana a Myrmex tramite le sue API: crea un token per un service account e aggiungi l'integrazione.

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

Collega la tua istanza **Grafana** in modo che Myrmex possa verificarne lo stato, ispezionare le dashboard e leggere le metriche. Myrmex raggiunge Grafana tramite la sua **API HTTP** attraverso un [Collector](/it/documentation/agent-endpoint-security/collector-mode) sulla tua rete. Ogni richiesta viene eseguita **in tempo reale, su richiesta**: Myrmex restituisce solo ciò che chiedi e non copia né memorizza nulla di Grafana dalla propria parte. Le credenziali vengono risolte dalla tua parte e non transitano mai attraverso il modello.

## Cosa può fare Myrmex

<CardGroup cols={2}>
  <Card title="Verificare lo stato" icon="heart-pulse">
    Leggi lo stato e la salute di Grafana per confermare che l'istanza sia attiva.
  </Card>

  <Card title="Ispezionare le dashboard" icon="table-columns">
    Elenca e ispeziona le dashboard in tempo reale per vedere cosa viene monitorato.
  </Card>

  <Card title="Leggere le metriche" icon="chart-line">
    Recupera le metriche tramite l'API su richiesta e restituisci solo ciò che hai chiesto.
  </Card>

  <Card title="Rivedere le data source" icon="database">
    Elenca le data source configurate per capire da dove provengono i dati.
  </Card>
</CardGroup>

## Prima di iniziare

* Un **Collector** in grado di raggiungere Grafana tramite HTTP o HTTPS (porta predefinita `3000`). Consulta [Modalità Collector](/it/documentation/agent-endpoint-security/collector-mode).
* Un **service account** (o API key) con almeno il ruolo **Viewer**.

## Passaggio 1 — Crea la credenziale in Grafana

<Steps>
  <Step title="Crea un service account">
    In Grafana, vai su **Administration → Users and access → Service accounts** e aggiungi un service account con il ruolo **Viewer**: è sufficiente per stato, dashboard e metriche.
  </Step>

  <Step title="Aggiungi un token">
    Sul service account, fai clic su **Add service account token**, imposta una scadenza facoltativa e copia il token. Myrmex lo invia come Bearer token.
  </Step>
</Steps>

<Tip>
  Usa un service account con il ruolo Viewer per il monitoraggio in sola lettura. Concedi un ruolo superiore solo se in seguito hai bisogno che Myrmex modifichi Grafana.
</Tip>

## Passaggio 2 — Aggiungi l'integrazione in Myrmex

Dalla **Directory**, scegli **Add Integration → Grafana**, quindi compila:

| Field                     | Description                                                                                     |
| ------------------------- | ----------------------------------------------------------------------------------------------- |
| **Name**                  | Un nome univoco per questa istanza Grafana.                                                     |
| **Description**           | Nota facoltativa per identificare l'istanza.                                                    |
| **API Token**             | Il token del service account creato nel Passaggio 1.                                            |
| **URL**                   | Host o IP di Grafana che il Collector può raggiungere.                                          |
| **Protocol**              | `http` o `https`.                                                                               |
| **Port**                  | La porta di Grafana (predefinita `3000`).                                                       |
| **Collector**             | Il [Collector](/it/documentation/agent-endpoint-security/collector-mode) che raggiunge Grafana. |
| **Authentication Method** | `bearer` (il token del service account).                                                        |

## Connessione

Fai clic su **Connect** per convalidare la connessione API e completare. Grafana comparirà quindi in **Environment → Integrations** e potrai porre domande al riguardo nel Workspace o tramite l'[agente Integration Specialist](/it/documentation/multi-agent-system/integration-specialist-agent).

<Note>
  Dietro un reverse proxy, Grafana potrebbe essere servito sulla porta `443` sotto un sotto-percorso. Punta URL e Port all'indirizzo che il Collector può effettivamente raggiungere.
</Note>