Configurare un server MCP remoto Grafana con gestione Azure

Ogni istanza di Grafana con gestione Azure include un endpoint server Model Context Protocol (MCP) integrato.

L'endpoint MCP gestito di Azure Grafana consente agli strumenti e alle applicazioni di interagire a livello di codice con l'istanza di Grafana che usa il mcp. L'endpoint MCP gestito di Azure Grafana usa lo stesso meccanismo di autenticazione dell'istanza di Grafana, supportando sia l'ID Microsoft Entra che il token dell'account del servizio Grafana.

Percorso endpoint

Il formato del percorso dell'endpoint MCP gestito di Azure Grafana è https://<grafana-endpoint>/api/azure-mcp.

Strumenti MCP disponibili

Grafana MCP gestito di Azure offre gli strumenti seguenti per interagire con Grafana gestito di Azure:

Nome dello strumento Descrizione
amgmcp_dashboard_search Cerca le dashboard di Grafana in base a una stringa di query. Restituisce un elenco di dashboard corrispondenti con dettagli come titolo, UID, cartella, tag e URL.
amgmcp_dashboard_inspect Ispeziona un dashboard di Grafana. Supporta la modalità riepilogativa, la modalità query dei pannelli (con sostituzione opzionale delle variabili dei modelli) e la modalità proprietà (letture JSONPath mirate sul JSON grezzo della dashboard).
amgmcp_dashboard_update Crea, sostituisce o applica patch a un dashboard di Grafana. Supporta il JSON completo della dashboard per la creazione/sostituzione oppure operazioni di patch mirate (aggiunta, sostituzione, rimozione) tramite JSONPath per modifiche puntuali.
amgmcp_prometheus_query Interroga Prometheus utilizzando un'espressione PromQL. Supporta interrogazioni istantanee (singolo punto) e interrogazioni su intervallo (intervallo di tempo).
amgmcp_prometheus_list_metric_names Elenca i nomi delle metriche presenti in un'origine dati di Prometheus. Supporta il filtro regex e la paginazione. Chiama prima questa funzione per ottenere i dati prima di eseguire la query.
amgmcp_prometheus_list_label_names Elenca i nomi delle etichette provenienti da una fonte di dati Prometheus. Supporta il filtro in base al selettore di serie e all'intervallo di tempo.
amgmcp_prometheus_query_histogram Calcola i percentili degli istogrammi a partire dalle metriche degli istogrammi di Prometheus. Compila histogram_quantile PromQL dal nome della metrica, dal percentile e dalle etichette facoltative.
amgmcp_pulse_check Esegue controlli di integrità automatizzati tra le risorse Azure (PostgreSQL, Cosmos DB, servizio Azure Kubernetes, Archiviazione, Key Vault, macchine virtuali, database SQL, piani di servizio app, Redis, App per la logica). Identifica le risorse con metriche anomale, ad esempio la saturazione elevata della CPU, la saturazione delle UR, la pressione della memoria o la disponibilità danneggiata. Genera anche riepiloghi sull'utilizzo per gli account di archiviazione e gli insiemi di credenziali. Restituisce un riepilogo con priorità dei risultati.
amgmcp_query_resource_graph Esegue query su Azure Resource Graph tramite un'origine dati di Monitoraggio di Azure di Grafana.
amgmcp_query_resource_metric Esegue query sui valori delle metriche delle risorse di Azure tramite il data source Grafana Monitoraggio di Azure.
amgmcp_query_resource_metric_definition Esegue interrogazioni sulle definizioni delle metriche delle risorse di Azure tramite una fonte dati Grafana Monitoraggio di Azure.
amgmcp_query_resource_log Esegue una query sul log delle risorse di Azure tramite un'origine dati di Monitoraggio di Azure di Grafana.
amgmcp_query_azure_subscriptions Elenca tutte le sottoscrizioni di Azure a cui l'origine dati di Grafana Monitoraggio di Azure può accedere.
amgmcp_insights_get_failures Ottiene informazioni dettagliate sugli errori. Restituisce i dati di riepilogo degli errori da Application Insights, ad esempio richieste non riuscite, dipendenze non riuscite ed eccezioni.
amgmcp_insights_get_agents Ottiene informazioni sull'agente di intelligenza artificiale generativa. Restituisce informazioni correlate agli agenti di intelligenza artificiale generativi da Application Insights, ad esempio chiamate dell'agente, utilizzo dei token e latenza. Interroga dati conformi alle convenzioni semantiche OpenTelemetry per l'intelligenza artificiale generativa, ad esempio i dati generati da OpenAI Python API, Google Cloud AI Agent Development Kit, Microsoft AI Foundry / Agent Toolkits, Microsoft Agent Framework, LangChain / LangGraph.
amgmcp_query_application_insights_trace Esegue query su una traccia di Application Insights tramite l'origine dati di Monitoraggio di Azure di Grafana. Quando i dati di traccia vengono archiviati in più istanze di Application Insights, questo strumento aggrega i dati.
amgmcp_kusto_get_metadata Ottiene i metadati per i cluster connessi di Esplora dati di Azure (Kusto). Elenca tutte le origini dati di Esplora dati di Azure e per ogni origine dati ottiene l'URL del cluster, dei database e dello schema.
amgmcp_kusto_query Esegue query sui dati in un cluster di Esplora dati di Azure (Kusto).
amgmcp_sql_get_metadata Ottiene metadati per fonti di dati connesse di Microsoft SQL Server, PostgreSQL e MySQL, inclusi database, tabelle e schemi di colonne.
amgmcp_sql_query Interroga una sorgente di dati Microsoft SQL Server, PostgreSQL o MySQL utilizzando il dialetto SQL della sorgente dati.
amgmcp_query_resource_health Query Azure Integrità risorse stato di disponibilità per una sottoscrizione, un gruppo di risorse o una singola risorsa. Supporta lo stato corrente e le transizioni storiche della disponibilità.
amgmcp_query_resource_health_events Interroga gli eventi relativi all'integrità del servizio di Azure Integrità risorse (problemi del servizio, manutenzione pianificata, avvisi di integrità, avvisi di sicurezza, RCA, problemi emergenti, eventi di fatturazione) a livello di sottoscrizione o di singola risorsa.
amgmcp_query_activity_log Interroga il log attività di Azure per esaminare le operazioni del piano di gestione (creazioni, eliminazioni, aggiornamenti, modifiche RBAC, distribuzioni e così via) sulle risorse di Azure.
amgmcp_cost_analysis Mostra l'analisi dei costi di Azure. Suddivide i costi in base al tipo di risorsa, all'area e alla categoria di servizio (MeterCategory). Supporta l'esecuzione di query su una singola sottoscrizione o su tutte le sottoscrizioni accessibili.
amgmcp_datasource_list Elenca tutte le origini dati di Grafana. Facoltativamente, filtra in base al tipo di origine dati.
amgmcp_alert_get_history Recupera la cronologia delle modifiche di stato per una regola di avviso gestita da Grafana in un intervallo di tempo.
amgmcp_alert_list Elenca le regole di allerta gestite da Grafana insieme al loro stato di valutazione in tempo reale e alle istanze di sparo.
amgmcp_alert_update Crea, sostituisce o patcha una regola di allerta gestita da Grafana. Supporta definizioni complete delle regole, operazioni di patch mirate e modalità solo validazione.
amgmcp_loki_list_labels Elenca nomi di etichette o valori da una sorgente di dati Loki per aiutare a costruire i selettori di flusso.
amgmcp_loki_query Le query registrano i dati da una sorgente di dati Loki usando LogQL.

Configurazione mcp

Per connettersi all'endpoint MCP gestito di Grafana di Azure, è necessario configurare il client MCP con le impostazioni appropriate. Grafana con gestione Azure MCP supporta i metodi di autenticazione seguenti:

Token dell'account del servizio Grafana

Usare un token dell'account del servizio Grafana per l'autenticazione. Per iniziare, creare un token:

  1. Nell'interfaccia utente dell'istanza di Grafana, vai su Amministrazione>Account di servizio.

  2. Creare un nuovo account del servizio usando le autorizzazioni appropriate.

  3. Generare un token.

  4. Copiare il token dell'account del servizio Grafana con il formato glsa_xxx. Incollarlo nelle impostazioni di configurazione:

    {
  "my-grafana-mcp-server": {
    "disabled": false,
    "timeout": 60,
    "type": "streamableHttp",
    "url": "https://my-grafana-d5ggtqegcr2safcp.wcus.grafana.azure.com/api/azure-mcp",
    "headers": {
      "Authorization": "Bearer glsa_xxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxx"
    }
  }
}

Token ID Microsoft Entra

Usare un token ID Microsoft Entra per l'autenticazione. Questo approccio è utile quando si usano identità gestite o entità servizio.

  • Usa interfaccia della riga di comando di Azure per ottenere un token Microsoft Entra ID per il pubblico https://dashboard.azure.comdi Grafana con gestione Azure.

    az account get-access-token --resource https://dashboard.azure.com --query accessToken -o tsv

  • In alternativa, utilizzare un'identità gestita per acquisire a livello di codice un token con i destinatari di Grafana con gestione Azure https://dashboard.azure.com.

    {
  "my-grafana-mcp-server": {
    "disabled": false,
    "timeout": 60,
    "type": "streamableHttp",
    "url": "https://my-grafana-d5ggtqegcr2safcp.wcus.grafana.azure.com/api/azure-mcp",
    "headers": {
      "Authorization": "Bearer <entra-id-token-for-https://dashboard.azure.com>"
    }
  }
}

Autenticazione OAuth con Microsoft Entra ID

Grafana MCP gestito di Azure supporta l'autenticazione OAuth usando Microsoft Entra ID. Non è necessaria alcuna configurazione manuale del token. Sono supportati i client seguenti:

  • Visual Studio Code con GitHub Copilot
  • Visual Studio con GitHub Copilot

Nella configurazione di Visual Studio Code o Visual Studio MCP aggiungere l'impostazione seguente. Sostituire <grafana-endpoint> con l'endpoint Grafana.

{
  "servers": {
    "my-grafana-mcp-server": {
      "type": "http",
      "url": "https://<grafana-endpoint>/api/azure-mcp"
    }
  }
}

Quando GitHub Copilot si connette al server MCP, viene richiesto di accedere con l'account MICROSOFT Entra ID.

Examples

Gli esempi seguenti illustrano la configurazione di Grafana con gestione Azure MCP in base al tipo di client.

Esempio 1: Visual Studio Code con il flusso OAuth

Visual Studio Code con GitHub Copilot supporta l'autenticazione OAuth con Microsoft Entra ID. Non è necessaria alcuna configurazione manuale del token. Il client MCP gestisce automaticamente il flusso OAuth e richiede di accedere con l'account Microsoft Entra ID.

{
  "<your-grafana-mcp-server-name>": {
    "type": "http",
    "url": "https://<grafana-endpoint>/api/azure-mcp"
  }
}

Parametri di configurazione

Parametro Descrizione
type Tipo di trasporto. Usare http per gli endpoint MCP remoti.
url URL dell'endpoint MCP gestito di Azure Grafana: https://<grafana-endpoint>/api/azure-mcp.

Esempio 2: Visual Studio Code con un token dell'account del servizio

Per configurare Visual Studio Code con un token dell'account del servizio Grafana, aggiungere l'intestazione Authorization con il token.

{
  "<your-grafana-mcp-server-name>": {
    "type": "http",
    "url": "https://<grafana-endpoint>/api/azure-mcp",
    "headers": {
      "Authorization": "Bearer glsa_xxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxx"
    }
  }
}

Parametri di configurazione

Parametro Descrizione
type Tipo di trasporto. Usare http per gli endpoint MCP remoti.
url URL dell'endpoint MCP gestito di Azure Grafana: https://<grafana-endpoint>/api/azure-mcp.
headers.Authorization Token al portatore che utilizza un token dell'account di servizio Grafana (glsa_xxx).

Esempio 3: Claude Code con un token dell'account di servizio

Per configurare MCP per Claude Code, usare impostazioni di configurazione simili all'esempio seguente. Usare un token dell'account del servizio Grafana per l'autenticazione.

{
  "<your-grafana-mcp-server-name>": {
    "disabled": false,
    "timeout": 60,
    "type": "streamableHttp",
    "url": "https://<grafana-endpoint>/api/azure-mcp",
    "headers": {
      "Authorization": "Bearer glsa_xxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxx"
    }
  }
}

Parametri di configurazione

Parametro Descrizione
disabled Impostare su false per abilitare la connessione al server MCP.
timeout Timeout della connessione in secondi.
type Tipo di trasporto. Usare streamableHttp per gli endpoint MCP remoti.
url URL dell'endpoint MCP gestito di Azure Grafana: https://<grafana-endpoint>/api/azure-mcp.
headers.Authorization Token al portatore che utilizza un token dell'account di servizio Grafana (glsa_xxx).

Esempio 4: OpenClaw con un token dell'account di servizio

Per configurare MCP per OpenClaw, usare il openclaw mcp set comando con un token dell'account del servizio Grafana.

openclaw mcp set mcp '{"url":"https://<grafana-endpoint>/api/azure-mcp","transport":"streamable-http","headers":{"Authorization":"Bearer glsa_xxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxx"}}'

Riavviare quindi il gateway per selezionare la configurazione:

openclaw gateway restart

Limitazioni

  • Attualmente, l'endpoint MCP gestito di Azure Grafana è incluso in Grafana gestito di Azure solo per le istanze del cloud pubblico di Azure, non per i cloud sovrani.
  • La connessione a Grafana con gestione Azure tramite un endpoint privato non è attualmente supportata.

Risoluzione dei problemi

Se si verificano problemi, aprire un problema nel repository GitHub di Grafana con gestione Azure.

Contenuti correlati

  • Last updated on