Condividi tramite


Azure strumenti server MCP per Monitoraggio di Azure e cartelle di lavoro

Il server MCP (Model Context Protocol) Azure consente di gestire le risorse Monitoraggio di Azure e Cartelle di lavoro con richieste di linguaggio naturale. È possibile eseguire query nelle aree di lavoro di Log Analytics, analizzare i dati operativi, monitorare lo stato di integrità delle risorse, recuperare le metriche sulle prestazioni e gestire le cartelle di lavoro di Monitoraggio di Azure.

Monitoraggio di Azure consente di ottimizzare la disponibilità e le prestazioni delle applicazioni e dei servizi. Offre una soluzione completa per la raccolta, l'analisi e l'esecuzione dei dati di telemetria dagli ambienti cloud e locali.

Le cartelle di lavoro offrono un canvas flessibile per l'analisi dei dati e la creazione di report visivi avanzati all'interno del portale di Azure. Consentono di accedere a molteplici origini dati da Azure e combinarle in esperienze interattive unificate. Le cartelle di lavoro consentono di combinare più tipi di visualizzazioni e analisi, risultando ideali per l'esplorazione in formato libero. Per ulteriori informazioni, vedere la documentazione di Monitoraggio di Azure workbooks.

Annotazioni

parametri Tool: gli strumenti server Azure MCP definiscono i parametri per i dati necessari per completare le attività. Alcuni di questi parametri sono specifici di ogni strumento e sono documentati di seguito. Altri parametri sono globali e condivisi da tutti gli strumenti. Per altre informazioni, vedere Parametri degli strumenti.

Log attività: ottenere i log attività

Elenca i log delle attività di Monitoraggio di Azure per una risorsa Azure specificata per un determinato numero di ore passate. Questo strumento consente di comprendere la cronologia della distribuzione delle risorse, le modifiche alla configurazione e i modelli di accesso. Restituisce eventi del log attività che includono timestamp, nome dell'operazione, stato e informazioni sul chiamante. Usare i risultati per analizzare le distribuzioni non riuscite, le modifiche impreviste o i problemi di accesso.

Alcuni prompt di esempio includono:

  • "Elencare i log attività per le ultime "720" ore per la risorsa "webapp-prod".
Parametro Obbligatorio o facoltativo Description
Nome risorsa Obbligatorio Nome della risorsa Azure per recuperare i log delle attività.
Livello di evento Opzionale Il livello dei log di attività da recuperare. I livelli validi sono: Critical, Error, InformationalVerbose, , Warning. Se non specificato, restituisce tutti i livelli.
Hours Opzionale Numero di ore antecedenti ad ora per recuperare i log attività.
Tipo di risorsa Opzionale Tipo della risorsa Azure, ad esempio 'Microsoft.Storage/storageAccounts'). Specificare questa opzione solo se necessario per evitare ambiguità tra più risorse con lo stesso nome.
Top Opzionale Il numero massimo di log attività da recuperare.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Test Web: creare o aggiornare test Web

Parte degli strumenti MCP (Model Context Protocol), questo strumento crea o aggiorna un test Web standard in Monitoraggio di Azure per verificare la disponibilità degli endpoint. È possibile specificare le impostazioni di monitoraggio, ad esempio URL, frequenza, posizioni e risposte previste. Se il test non esiste, questo strumento lo crea; in caso contrario, aggiorna il test esistente con le nuove impostazioni.

Alcuni prompt di esempio includono:

  • Creare un nuovo test Web Standard con la risorsa webtest 'webtest-prod-availability' nel gruppo di risorse 'rg-prod-monitoring' e associarlo al componente AppInsights '/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod'.
  • Aggiornare un test Web Standard esistente per la risorsa webtest 'webtest-prod-availability' nel gruppo di risorse 'rg-prod-monitoring' per collegarlo al componente AppInsights '/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod'.
Parametro Obbligatorio o facoltativo Description
Gruppo di risorse Obbligatorio Nome del gruppo di risorse Azure.
Risorsa test Web Obbligatorio Nome della risorsa test Web su cui operare.
Componente Appinsights Opzionale ID risorsa del componente di Application Insights da associare al Test Web.
Descrizione Opzionale Breve descrizione del test Web.
abilitato Opzionale Indica se il test Web è abilitato.
Codice di stato previsto Opzionale Codice di stato HTTP previsto.
Seguire i reindirizzamenti Opzionale Indica se seguire i reindirizzamenti HTTP.
Frequenza Opzionale Frequenza di test in secondi. Valori supportati: 300, 600, 900.
Headers Opzionale Intestazioni HTTP da includere nella richiesta, come coppie KEY=VALUE separate da virgole.
Verbo HTTP Opzionale Metodo HTTP da usare, ad esempio get o post.
Ignora codice di stato Opzionale Indica se ignorare la convalida del codice di stato.
Ubicazione Opzionale La posizione in cui viene creata la risorsa di test Web. Deve corrispondere alla posizione del componente Application Insights.
Analizzare le richieste Opzionale Indica se analizzare le richieste dipendenti.
Corpo della richiesta Opzionale Il corpo da inviare con la richiesta.
Richiesta URL Opzionale URL assoluto da testare.
Ripetizione attivata Opzionale Indica se i tentativi sono abilitati.
Controllo SSL Opzionale Indica se convalidare i certificati SSL.
Controllo della durata SSL Opzionale Numero di giorni per controllare la durata del certificato SSL.
Timeout Opzionale Timeout della richiesta in secondi. Valori supportati: 30, 60, 90, 120.
Nome Test Web Opzionale Nome del test all'interno della risorsa di test Web.
Percorsi di test Web Opzionale Elenco delimitato da virgole di percorsi da cui eseguire il test. La località fa riferimento al tag di popolamento della posizione geografica per i test di disponibilità.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ✅ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌

Test Web: Ottieni test Web

Questo strumento ottiene i dettagli per un test Web specifico o elenca tutti i test Web. Quando si specifica la risorsa Webtest, questo strumento restituisce informazioni dettagliate per il test Web. Quando non si specifica la risorsa Webtest, questo strumento restituisce un elenco di tutti i test Web nella sottoscrizione ed è possibile filtrare l'elenco in base al gruppo di risorse.

Alcuni prompt di esempio includono:

  • Ottieni i dettagli del test Web per la risorsa webtest 'webtest-prod' nella mia sottoscrizione nel gruppo di risorse 'rg-monitoring'.
  • "Elencare tutte le risorse Test Web nella mia sottoscrizione."
  • Elenca tutte le risorse Web Test nella mia sottoscrizione nel gruppo di risorse 'rg-prod'.
Parametro Obbligatorio o facoltativo Description
Risorsa test Web Opzionale Nome della risorsa test Web su cui operare.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Log Analytics: Elencare le aree di lavoro

Questo strumento elenca le aree di lavoro di Log Analytics all'interno di una sottoscrizione. Recupera il nome, l'ID, la posizione e altre proprietà chiave di ogni area di lavoro. È possibile usarlo per identificare le aree di lavoro prima di eseguire query sui log o esaminare le impostazioni dell'area di lavoro.

Alcuni prompt di esempio includono:

  • Elenca le aree di lavoro Log Analytics nella mia sottoscrizione.
  • "Visualizzare le aree di lavoro Log Analytics."
  • Ottieni le aree di lavoro Log Analytics nella mia sottoscrizione.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Log Analytics: Elenco delle tabelle

Questo strumento elenca tutte le tabelle in un'area di lavoro Log Analytics. Ad esempio, elencare le tabelle nell'area di lavoro 'prod-law' nel gruppo di risorse 'rg-monitoring' per visualizzare in anteprima le colonne e i tipi di dati disponibili. Restituisce nomi di tabella e schemi usati per compilare query KQL (Kusto Query Language). È possibile filtrare in base al tipo di tabella, ad esempio CustomLog o AzureMetrics.

Alcuni prompt di esempio includono:

  • Elenca tutte le tabelle nell'area di lavoro di Log Analytics 'prod-law' di tipo 'CustomLog' nel gruppo di risorse 'rg-prod'.
  • "Mostra tabelle di tipo tabella 'AzureMetrics' per l'area di lavoro 'f1b2c3d4-5678-90ab-cdef-1234567890ab' nel gruppo di risorse 'rg-monitoring'".
Parametro Obbligatorio o facoltativo Description
Nome dell'area di lavoro Opzionale ID o nome dell'area di lavoro Log Analytics. Può trattarsi dell'identificatore univoco (GUID) o del nome visualizzato dell'area di lavoro.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Log Analytics: Ottenere i tipi di tabella

Questo strumento MCP (Model Context Protocol) elenca i tipi di tabella disponibili in un'area di lavoro Log Analytics di Azure. Restituisce i nomi dei tipi di tabella. È possibile usare questi nomi quando si scrivono query su Monitoraggio di Azure log.

Alcuni prompt di esempio includono:

  • "Elencare tutti i tipi di tabella disponibili in Log Analytics nome dell'area di lavoro 'prod-law-01' nel gruppo di risorse 'rg-prod'."
  • "Quali tipi di tabella sono disponibili in Log Analytics nome dell'area di lavoro 'analytics-workspace' nel gruppo di risorse 'rg-logs'?"
Parametro Obbligatorio o facoltativo Description
Gruppo di risorse Obbligatorio Nome del gruppo di risorse Azure che contiene l'area di lavoro.
Nome dell'area di lavoro Obbligatorio Nome o ID dell'area di lavoro Log Analytics. È possibile usare il GUID dell'area di lavoro o il nome visualizzato.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Log Analytics: Eseguire query sui log dell'area di lavoro

Eseguire query sui registri in un'intera area di lavoro di Log Analytics usando il linguaggio di query Kusto (KQL). Questo strumento esegue query a livello di area di lavoro che restituiscono log su tutte le risorse e tabelle all'interno dell'area di lavoro. Questo strumento fa parte degli strumenti MCP (Model Context Protocol). Ad esempio, è possibile chiedere: 'mostra tutti gli errori nell'area di lavoro', 'cosa è successo nell'area di lavoro nelle ultime 24 ore', 'elencare le richieste non riuscite nell'area di lavoro'.

Alcuni prompt di esempio includono:

  • "Mostra i log con la query 'errors' dalla tabella 'Syslog' nell'area di lavoro di Log Analytics 'my-workspace' nel gruppo di risorse 'rg-prod'."
Parametro Obbligatorio o facoltativo Description
Quesito Obbligatorio Query KQL (Kusto Query Language) da eseguire sull'area di lavoro Log Analytics. È possibile usare query predefinite in base al nome: recent mostra i log più recenti, ordinati in base a TimeGenerated. errors Visualizza i log a livello di errore, ordinati in base a TimeGenerated. In alternativa, fornire una query KQL personalizzata.
Gruppo di risorse Obbligatorio Nome del gruppo di risorse Azure che contiene l'area di lavoro.
Nome della tabella Obbligatorio Nome della tabella su cui eseguire una query all'interno dell'area di lavoro.
Nome dell'area di lavoro Obbligatorio ID o nome dell'area di lavoro Log Analytics. È possibile specificare l'identificatore univoco globale (GUID) o il nome visualizzato dell'area di lavoro.
Hours Opzionale Numero di ore di query da ora in poi.
Limit Opzionale Il numero massimo di risultati da restituire.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Log Analytics: Eseguire query sui log delle risorse

Eseguire query sui log di diagnostica e attività per una risorsa Azure specifica in un'area di lavoro Log Analytics usando KQL (Kusto Query Language). Questo strumento filtra i risultati nella risorsa specificata ed esegue la query KQL fornita sulla tabella scelta. Ad esempio, chiedere "Mostra log per la risorsa "app-monitor" per le ultime 24 ore".

Alcuni prompt di esempio includono:

  • Mostra i log con la query 'recent' per l'ID risorsa '/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/rg-prod/providers/Microsoft.Compute/virtualMachines/my-vm' nella tabella 'AzureDiagnostics'.
Parametro Obbligatorio o facoltativo Description
Quesito Obbligatorio Query KQL da eseguire sull'area di lavoro Log Analytics. È possibile usare query predefinite in base al nome: recent mostra i log più recenti ordinati da TimeGenerated. errors Mostra i log a livello di errore ordinati in base a TimeGenerated. In caso contrario, specificare una query KQL personalizzata.
ID risorsa Obbligatorio L'ID della risorsa Azure per la risorsa da interrogare. Esempio: /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.OperationalInsights/workspaces/<ws>.
Nome della tabella Obbligatorio Nome della tabella su cui eseguire una query all'interno dell'area di lavoro.
Hours Opzionale Numero di ore di query da ora in poi.
Limit Opzionale Il numero massimo di risultati da restituire.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Integrità: ottenere l'integrità dell'entità

Questo strumento recupera lo stato di integrità e gli eventi di integrità recenti per un'entità specifica in un modello di integrità Monitoraggio di Azure. Lo strumento Model Context Protocol (MCP) segnala l'integrità a livello di applicazione in base ai modelli di integrità personalizzati, non alla disponibilità delle risorse di base. Per la disponibilità delle risorse di base, usare Azure Integrità risorse o lo strumento azmcp_resourcehealth_availability-status_get. Per eseguire query sui log in un'area di lavoro Log Analytics, usare azmcp_monitor_workspace_log_query. Per eseguire query sui log per una risorsa Azure specifica, usare azmcp_monitor_resource_log_query.

Alcuni prompt di esempio includono:

  • "Mostra lo stato di integrità dell'entità 'order-service' usando il modello di integrità 'app-health-v1' nel gruppo di risorse 'rg-prod'."
Parametro Obbligatorio o facoltativo Description
Nome dell'entità Obbligatorio Entità per cui ottenere lo stato di salute.
Modello di salute Obbligatorio Nome del modello di salute per il quale ottenere lo stato di salute.
Gruppo di risorse Obbligatorio Nome del gruppo di risorse Azure. Questo gruppo di risorse è un contenitore logico per Azure risorse.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Metriche: metriche di interrogazione

Effettuare query sulle metriche di Monitoraggio di Azure per una risorsa. Questo strumento restituisce i dati delle serie temporali per le metriche specificate, consentendo di analizzare le prestazioni e la disponibilità delle risorse. Questo strumento fa parte degli strumenti MCP (Model Context Protocol).

Alcuni prompt di esempio includono:

  • "Analizzare le tendenze delle prestazioni e i tempi di risposta per la risorsa di Application Insights 'appinsights-prod' con le metriche 'requests/duration' e il namespace metriche 'microsoft.insights/components'."
  • Controlla la metrica di disponibilità 'availabilityResults/availabilityPercentage' per la risorsa di Application Insights 'appinsights-staging' utilizzando lo spazio dei nomi delle metriche 'microsoft.insights/components'.
  • Ottenere la metrica 'requests/duration' con aggregazione 'Average' e intervallo 'PT1M' per la risorsa 'appinsights-prod' usando lo spazio dei nomi delle metriche 'microsoft.insights/components'.
  • "Analizzare le percentuali di errore e le richieste non riuscite per la risorsa di Application Insights 'appinsights-prod' usando le metriche 'requests/failed,exceptions/count' e lo spazio dei nomi delle metriche 'microsoft.insights/components'".
  • Eseguire una query sulla metrica 'requests/count' per il tipo di risorsa 'Microsoft.Insights/components' risorsa 'appinsights-qa' con spazio dei nomi delle metriche 'microsoft.insights/components' e intervallo 'PT5M'.
  • "Qual è la frequenza delle richieste al secondo usando la metrica 'requests/count' con l'aggregazione 'Count' per la risorsa di Application Insights 'appinsights-prod' e lo spazio dei nomi delle metriche 'microsoft.insights/components'?"
Parametro Obbligatorio o facoltativo Description
Nomi delle metriche Obbligatorio Nomi delle metriche su cui eseguire query, delimitati da virgole.
Namespace delle metriche Obbligatorio Spazio dei nomi della metrica da interrogare. Ottenere questo valore dallo strumento azmcp-monitor-metrics-definitions.
Nome risorsa Obbligatorio Nome della risorsa Azure per cui eseguire query sulle metriche.
Aggregazione Opzionale Tipo di aggregazione da usare, ad esempio Average, Maximum, Minimum, Total o Count.
Ora di fine Opzionale Ora di fine della query in formato ISO, ad esempio 2023-01-01T00:00:00Z. Il valore predefinito è ora.
Filter Opzionale Filtro OData da applicare alla query delle metriche.
Intervallo Opzionale Intervallo di tempo per i punti dati, PT1H ad esempio per 1 ora, PT5M per 5 minuti.
Numero massimo di bucket Opzionale Numero massimo di bucket di tempo da restituire. Il valore predefinito è 50.
Tipo di risorsa Opzionale Tipo di risorsa Azure, ad esempio Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Se non specificato, lo strumento tenta di dedurre il tipo dal nome della risorsa.
ora di inizio Opzionale Ora di inizio della query in formato ISO, ad esempio 2023-01-01T00:00:00Z. Il valore predefinito è 24 ore fa.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Metriche: elencare le definizioni delle metriche

Questo strumento elenca le definizioni delle metriche per una risorsa Azure. Restituisce i metadati relativi a ogni metrica, inclusi spazi dei nomi, descrizioni e tipi di aggregazione, in modo da determinare le metriche di cui eseguire query per una risorsa.

Alcuni prompt di esempio includono:

  • "Ottenere le definizioni delle metriche per il nome della risorsa 'app-insights-prod'".
  • "Elencare le definizioni delle metriche per il nome della risorsa 'mystorageacct' con il tipo di risorsa 'Microsoft.Storage/storageAccounts' e namespace delle metriche 'Storage'."
  • "Mostra definizioni delle metriche per il nome della risorsa 'vm-prod-01' con la stringa di ricerca 'cpu' e limite '20'".
Parametro Obbligatorio o facoltativo Description
Nome risorsa Obbligatorio Nome della risorsa Azure per cui eseguire query sulle metriche.
Limit Opzionale Numero massimo di definizioni delle metriche da restituire. L’impostazione predefinita è 10.
Namespace delle metriche Opzionale Spazio dei nomi della metrica da interrogare. Ottenere questo valore dallo strumento azmcp-monitor-metrics-definitions.
Tipo di risorsa Opzionale Tipo di risorsa Azure, ad esempio Microsoft.Storage/storageAccounts, Microsoft.Compute/virtualMachines). Se non lo si specifica, lo strumento tenta di dedurre il tipo di risorsa dal nome della risorsa.
Stringa di ricerca Opzionale Stringa per filtrare le definizioni delle metriche. Il filtro esegue la corrispondenza senza distinzione tra maiuscole e minuscole per il nome e la descrizione della metrica.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Strumentazione: Ottieni una risorsa di apprendimento

Questo strumento elenca tutte le risorse di apprendimento disponibili per Monitoraggio di Azure strumentazione oppure recupera il contenuto di una risorsa specifica in base al percorso. Per impostazione predefinita, lo strumento restituisce tutti i percorsi delle risorse. Se si specifica un percorso, lo strumento restituisce il contenuto completo della risorsa. Per instrumentare un'applicazione, usare lo strumento orchestrator-start.

Alcuni prompt di esempio includono:

  • "Ottenere la risorsa di apprendimento di onboarding nel percorso "onboarding/get-started.md".
  • "Mostra il contenuto della risorsa di apprendimento Monitoraggio di Azure onboarding nel percorso "onboarding/quickstart.md".
  • "Recuperare il contenuto del file di risorse di apprendimento Monitoraggio di Azure nel percorso 'samples/instrumentation-guide.html'".
  • Elencare tutte le risorse di apprendimento per l'onboarding di Monitoraggio di Azure.
  • "Visualizza tutti i percorsi dei materiali didattici per la strumentazione di Monitoraggio di Azure."
  • "Quali risorse di apprendimento sono disponibili per l'onboarding della strumentazione di Monitoraggio di Azure?"
Parametro Obbligatorio o facoltativo Description
Percorso Opzionale Percorso delle risorse di apprendimento.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ✅

Strumentazione: avviare l'orchestrazione

Iniziare da qui per gli strumenti MCP (Model Context Protocol) che instrumentano Monitoraggio di Azure. Questo strumento analizza l'area di lavoro e restituisce la prima azione da eseguire. Dopo aver eseguito l'azione, chiamare orchestrator-next per continuare. Seguire esattamente l'azione nel campo instruction.

Alcuni prompt di esempio includono:

  • "Avvia l'orchestrazione della strumentazione di Monitoraggio di Azure per il percorso dell'area di lavoro '/home/dev/workspace-monitoring'."
  • Analizzare il percorso dell'area di lavoro '/src/projects/my-app-workspace' e restituire il primo passaggio di strumentazione di Monitoraggio di Azure.
  • Inizia l'onboarding guidato di Monitoraggio di Azure per il progetto nel percorso dell'area di lavoro '/workspace/my-app' e forniscimi il passaggio 1.
Parametro Obbligatorio o facoltativo Description
Percorso dell'area di lavoro Obbligatorio Percorso assoluto della cartella dell'area di lavoro.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ❌ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ✅

Strumentazione: continua orchestrazione

Ottieni l'azione di strumentazione successiva dopo aver completato quella corrente.

Questo strumento fa parte della suite MCP (Model Context Protocol).

Dopo aver eseguito l'esatto instruction della risposta precedente, eseguire questo strumento per ottenere l'azione successiva.

Flusso di lavoro previsto:

  1. Ricevi un'azione da orchestrator-start o orchestrator-next.
  2. Esegui il campo instruction esattamente.
  3. Si esegue questo strumento con un Completion note conciso per ottenere l'azione successiva.

Restituisce: azione successiva da eseguire o complete stato al termine di tutti i passaggi.

Alcuni prompt di esempio includono:

  • Dopo aver completato il passaggio di strumentazione precedente su Monitoraggio di Azure, ricevere l'azione successiva per l'ID sessione 'session-abc123' con la nota di completamento: 'Aggiunto UseAzureMonitor() a Program.cs'.
  • "Ottenere l'azione di onboarding successiva per l'ID sessione 'workspace/session-2026' con la nota di completamento 'Ran dotnet add package Microsoft. ApplicationInsights'."
  • Dopo aver completato il passaggio di strumentazione precedente, passare al passaggio successivo per l'ID sessione "session-789xyz" con la nota di completamento "Aggiornato il file appsettings.json per abilitare Application Insights".
Parametro Obbligatorio o facoltativo Description
Nota di completamento Obbligatorio Una frase che descrive ciò che è stato eseguito, ad esempio , 'Ran dotnet add package command' o 'Added UseAzureMonitor() to Program.cs'.
ID Sessione Obbligatorio Percorso dell'area di lavoro restituito come sessionId da orchestrator-start.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ❌ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ✅

Strumentazione: Invia analisi brownfield

Invia i risultati dell'analisi del codice brownfield dopo che orchestrator-start restituisce lo stato analysis_needed. Questo strumento fa parte del flusso di lavoro MCP (Model Context Protocol). È necessario analizzare i file di origine dell'area di lavoro e compilare il modello di analisi prima di chiamare questo strumento. Una volta completato questo strumento, continuare con orchestrator-next.

Alcuni prompt di esempio includono:

  • Inviare i risultati dell'analisi del codice brownfield nel formato JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' alla sessione di strumentazione 'workspace-7a3b' di Monitoraggio di Azure dopo che l'analisi è stata richiesta.
  • Continuare l'orchestrazione della migrazione inviando il JSON dei risultati '{"serviceOptions":{"found":true,"details":"AddApplicationInsightsTelemetry used"},"initializers":[],"processors":[],"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' alla sessione 'sess-01234'.
  • Inviare l'analisi dei dati di telemetria brownfield completati come risultati JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":{"found":true},"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":{"found":true}}' per la sessione di onboarding 'session-9f3b'.
Parametro Obbligatorio o facoltativo Description
Risultati JSON Obbligatorio Oggetto JSON con risultati dell'analisi brownfield. Proprietà obbligatorie: serviceOptions (risultati delle opzioni del servizio dall'analisi della chiamata AddApplicationInsightsTelemetry(), null se non viene trovato), inizializzatori (risultati degli inizializzatori di telemetria dall'analisi delle implementazioni di ITelemetryInitializer o IConfigureOptions, null se non trovati), processori (risultati dei processori di telemetria dall'analisi delle implementazioni di ITelemetryProcessor, null se non trovati), clientUsage (risultati di utilizzo di TelemetryClient dall'analisi dell'utilizzo diretto di TelemetryClient, null se non trovato), sampling (risultati della configurazione di campionamento personalizzata, null se non è stato eseguito alcun campionamento personalizzato), telemetryPipeline (risultati dell'uso di ITelemetryChannel o TelemetrySinks, null se non trovato), logging (provider di logger esplicito e risultati del filtro, null se non trovato). Per le sezioni che non esistono nella codebase, passare un oggetto predefinito vuoto, ad esempio trovato: false o hasCustomSampling: false, anziché null.
ID Sessione Obbligatorio Il percorso dell'area di lavoro restituito come sessionId da orchestrator-start.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ❌ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ✅

Strumentazione: Seleziona miglioramento invio

Inviare la selezione di miglioramento dell'utente dopo che orchestrator-start ha restituito lo stato enhancement_available. Presentare le scelte di miglioramento all'utente, quindi chiamare questo strumento con le chiavi di miglioramento scelte. È possibile selezionare più miglioramenti passando un elenco delimitato da virgole, ad esempio redis,processors. Dopo che questo strumento ha avuto successo, continuare con orchestrator-next.

Alcuni prompt di esempio includono:

  • Inviare le chiavi di ottimizzazione 'redis,processori' per Monitoraggio di Azure ID di sessione di strumentazione 'workspaces/my-app/session-abc123'.
  • "Continua il flusso di miglioramento della strumentazione inviando chiavi di miglioramento 'redis' all'ID sessione 'workspaces/prod-app/session-789'".
  • "Inviare chiavi di miglioramento scelte 'entityframework,otlp' per l'onboarding dell'ID sessione 'workspaces/onboard/session-456'."
Parametro Obbligatorio o facoltativo Description
Tasti di potenziamento Obbligatorio Uno o più tasti di miglioramento, delimitati da virgole (ad esempio, redis, redis,processors, entityframework,otlp).
ID Sessione Obbligatorio Il percorso dell'area di lavoro restituito come sessionId da orchestrator-start.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ❌ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ✅

Cartelle di lavoro: Elenca le cartelle di lavoro

Cercare Azure cartelle di lavoro usando Resource Graph per eseguire query rapide sui metadati. Questo strumento consente di individuare, filtrare e contare cartelle di lavoro in ambiti diversi.

Restituisce i metadati della cartella di lavoro, inclusi id, name, location, category e i timestamp. Per impostazione predefinita, non restituisce il contenuto completo della cartella di lavoro (serializedData) — usare lo strumento di visualizzazione per farlo o impostare Output format su full.

Per impostazione predefinita, la ricerca si riferisce alle cartelle di lavoro nel contesto di Azure corrente (tenant/sottoscrizione). È possibile usare Resource group per specificare in modo esplicito l'ambito di ricerca. Lo strumento restituisce il conteggio totale lato server per impostazione predefinita. I risultati massimi restituiti sono 50, con un limite massimo di 1000; regolare questa impostazione con Max results. Scegliere Output format come summary per i token minimi o full per l'output completo serializedData .

Alcuni prompt di esempio includono:

  • "Mostra tutte le cartelle di lavoro nel gruppo di risorse "monitoring-rg".
  • "Elencare le cartelle di lavoro condivise nel gruppo di risorse "prod-rg".
  • "Quali cartelle di lavoro sono state modificate dopo il 2024-01-15 nel gruppo di risorse 'analytics-rg'?"
Parametro Obbligatorio o facoltativo Description
Gruppo di risorse Opzionale Nome del gruppo di risorse Azure per definire l'ambito della ricerca.
Categoria Opzionale Filtrare le cartelle di lavoro per categoria (ad esempio, workbook, sentinel, TSG). Se non specificato, vengono restituite tutte le categorie.
Includi conteggio totale Opzionale Includere il conteggio totale di tutte le cartelle di lavoro corrispondenti nella risposta (impostazione predefinita: true).
Kind Opzionale Filtrare le cartelle di lavoro in base al tipo, ad esempio shared, user. Se non specificato, vengono restituiti tutti i tipi.
Numero massimo di risultati Opzionale Numero massimo di risultati da restituire (valore predefinito: 50, max: 1000).
Modificato dopo Opzionale Filtrare le cartelle di lavoro modificate dopo questa data (formato ISO 8601, ad esempio ). 2024-01-15
Nome contiene Opzionale Filtrare le cartelle di lavoro in cui il nome visualizzato contiene questo testo (senza distinzione tra maiuscole e minuscole).
Formato di output Opzionale Formato di output: summary (solo ID e nome, token minimi), standard (metadati senza contenuto, impostazione predefinita), full (include serializedData).
ID origine Opzionale Filtrare le cartelle di lavoro in base all'ID risorsa di origine, ad esempio /subscriptions/abc123/resourceGroups/prod/providers/Microsoft.Insights/components/myapp. Se non specificato, vengono restituite tutte le cartelle di lavoro.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Cartelle di lavoro: mostra i dettagli della cartella di lavoro

Recuperare i dettagli della cartella di lavoro tramite l'API ARM (Azure Resource Manager), incluso il contenuto serializedData. Questo comando consente di ottenere la definizione completa della cartella di lavoro, inclusa la visualizzazione JSON.

Restituisce le proprietà complete della cartella di lavoro, i serializedDatatag e ETag. È possibile specificare più Workbook IDs per le operazioni batch. Il comando segnala errori parziali per singole cartelle di lavoro. Per ottenere prestazioni migliori, usare prima lo strumento elenco per individuare le cartelle di lavoro, quindi usare show per cartelle di lavoro specifiche.

Alcuni prompt di esempio includono:

  • "Mostra i dettagli della cartella di lavoro con ID risorsa '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft. Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1e1'."
  • "Ottenere la definizione completa della cartella di lavoro '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2'."
Parametro Obbligatorio o facoltativo Description
ID cartelle di lavoro Obbligatorio ID risorsa Azure delle cartelle di lavoro da recuperare. Supporta più valori per le operazioni batch.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ❌ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌

Cartelle di lavoro: Creare una cartella di lavoro

Creare una nuova cartella di lavoro nel gruppo di risorse e nella sottoscrizione specificati. È possibile impostare il nome visualizzato e il contenuto JSON serializzato per la cartella di lavoro. Questo comando restituisce le informazioni della cartella di lavoro create al termine dell'operazione.

Alcuni prompt di esempio includono:

  • Creare un nuovo workbook denominato "Dashboard delle prestazioni" nel gruppo di risorse 'monitoring-rg' con il contenuto serializzato per un notebook di base.
  • "Creare una cartella di lavoro denominata "Panoramica dell'infrastruttura" nel gruppo di risorse "prod-rg" con contenuto che mostra le metriche delle macchine virtuali."
Parametro Obbligatorio o facoltativo Description
Nome visualizzato Obbligatorio Nome visualizzato della cartella di lavoro.
Gruppo di risorse Obbligatorio Nome del gruppo di risorse Azure contenente la cartella di lavoro.
Contenuto serializzato Obbligatorio Contenuto JSON serializzato della cartella di lavoro.
ID origine Opzionale ID risorsa collegata per la cartella di lavoro. Per impostazione predefinita, tale valore è azure monitor.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ✅ | Idempotente: ❌ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌

Cartelle di lavoro: aggiornare la cartella di lavoro

Aggiornare le proprietà di una cartella di lavoro di Azure esistente aggiungendo nuovi passaggi, modificando il contenuto o modificando il nome visualizzato. Questa azione restituisce i dettagli della cartella di lavoro aggiornati. È necessario l'ID risorsa della cartella di lavoro e puoi specificare un nuovo contenuto serializzato o un nuovo nome visualizzato.

Alcuni prompt di esempio includono:

  • Aggiornare la cartella di lavoro '/subscriptions/abc123/resourceGroups/monitoring-rg/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1' con nome visualizzato "Report mensile".
  • "Modificare il contenuto serializzato della cartella di lavoro '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft. Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' per includere un nuovo grafico delle metriche."
Parametro Obbligatorio o facoltativo Description
ID cartella di lavoro Obbligatorio ID della risorsa Azure della cartella di lavoro da aggiornare.
Nome visualizzato Opzionale Nome visualizzato della cartella di lavoro.
Contenuto serializzato Opzionale Contenuto serializzato JSON della cartella di lavoro.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ✅ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌

Cartelle di lavoro: Elimina cartelle di lavoro

Eliminare una o più cartelle di lavoro in base agli ID risorsa Azure. Questo comando esegue un'eliminazione temporanea nelle cartelle di lavoro, conservandole per 90 giorni. È possibile ripristinarli dal Cestino tramite il portale di Azure, se necessario.

Per le operazioni batch, è possibile specificare più Workbook IDs valori. Il comando segnala errori parziali per ogni cartella di lavoro, assicurandosi che singoli errori non influiscano sull'intera operazione batch.

Per altre informazioni, vedere Gestire le cartelle di lavoro Monitoraggio di Azure.

Alcuni prompt di esempio includono:

  • Eliminare il workbook con ID risorsa '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1'.
  • Rimuovere le cartelle di lavoro con ID risorsa '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' e '/subscriptions/def456/resourceGroups/analytics-rg/providers/Microsoft.Insights/workbooks/c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3'.
Parametro Obbligatorio o facoltativo Description
ID cartelle di lavoro Obbligatorio ID delle risorse Azure delle cartelle di lavoro da eliminare. Supporta più valori per le operazioni batch.

Indicazioni per l'annotazione degli strumenti:

Distruttivo: ✅ | Idempotente: ✅ | Mondo Aperto: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌