Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Note
Azure AI Search è disponibile tramite il portale di Azure, le API REST e Azure SDK. È inoltre alla base di Foundry IQ, il livello di conoscenza gestito che trasforma il contenuto aziendale in knowledge base riutilizzabili e con riconoscimento delle autorizzazioni per gli agenti nel portale di Microsoft Foundry.
Questo articolo contiene tutte le informazioni di riferimento per il monitoraggio di questo servizio.
Vedere Monitor Azure AI Search per informazioni dettagliate sui dati che è possibile raccogliere per Azure AI Search e su come usarli.
Metriche
Questa sezione elenca tutte le metriche raccolte automaticamente per questa piattaforma per questo servizio. Queste metriche fanno anche parte dell'elenco globale di tutte le metriche della piattaforma supportate in Monitoraggio di Azure.
Per informazioni sulla conservazione delle metriche, vedi Monitoraggio di Azure Panoramica delle metriche.
Metriche supportate per Microsoft. Search/searchServices
Nella tabella seguente sono elencate le metriche disponibili per il tipo di risorsa Microsoft.Search/searchServices.
- Tutte le colonne potrebbero non essere presenti in ogni tabella.
- Alcune colonne potrebbero essere oltre l'area di visualizzazione della pagina. Seleziona Espandi tabella per visualizzare tutte le colonne disponibili.
Intestazioni di tabella
- Categoria - Il gruppo o classificazione delle metriche.
- Metric - Nome metrico visualizzato così come appare nel portale Azure.
- Nome nell'API REST - Il nome della metrica come indicato nell'API REST.
- Unità - Unità di misura.
- Aggregazione - Il tipo di aggregazione predefinito. Valori validi: Media (Media), Minimo (Min), Massimo (Max), Totale (Somma), Conteggio.
- Dimensioni - Dimensioni disponibili per la metrica.
-
Unità di Tempo - Intervalli in cui la metrica viene campionata. Ad esempio,
PT1Mindica che la metrica viene campionata ogni minuto,PT30Mogni 30 minuti,PT1Hogni ora, e così via. - DS Export- Se la metrica è esportabile in Monitoraggio di Azure Logs tramite le impostazioni diagnostiche. Per informazioni sull'esportazione delle metriche, consulta Crea impostazioni diagnostiche in Monitoraggio di Azure.
| Metrica | Nome nell'API REST | Metriche avanzate della piattaforma | Unità | Aggregazione | Dimensioni | Granularità temporale | Esportazione DS |
|---|---|---|---|---|---|---|---|
|
File elaborati dall'indicizzatore (byte) Numero totale di byte dei dati di origine elaborati dagli indicizzatori provenienti da un'origine dati basata su file (ad esempio Blob, ADLS Gen2, File, SharePoint, OneLake) |
DocumentsProcessedBytes |
No | Bytes | Totale (somma), Media |
DataSourceName, IndexerName, IndexName |
PT1M | Sì |
|
Conteggio dei documenti elaborati Numero di documenti elaborati |
DocumentsProcessedCount |
No | Conteggio | Totale (somma), numero di elementi |
DataSourceName, Failed, IndexerName, IndexNameSkillsetName |
PT1M | Sì |
|
Utilizzo dello spazio di archiviazione Utilizzo dell'archiviazione (testo e vettore) per il servizio di ricerca per indice |
IndexStorageUsage |
No | Bytes | Valore medio, Massimo, Minimo | IndexName |
PT1M | Sì |
|
Utilizzo dell'archiviazione vettoriale Utilizzo dell'archiviazione vettoriale per il servizio di ricerca per indice |
IndexVectorUsage |
No | Bytes | Valore medio, Massimo, Minimo | IndexName |
PT1M | Sì |
|
Unità di calcolo usate Unità di calcolo consumate dalle operazioni del servizio di ricerca e dai periodi di mantenimento in memoria dell'indice, in micro ore-CU (dividere il totale per 1.000.000 per ottenere le ore-CU). Il filtro di stato è obsoleto. |
PerRequestComputeConsumption |
No | Conteggio | Totale (somma), Media |
Status, IndexName, ResourceKindEventType |
PT1M | Sì |
|
Latenza di ricerca Latenza di ricerca media per il servizio di ricerca |
SearchLatency |
No | Secondi | Nella media | <nessuna> | PT1M | Sì |
|
Ricerche al secondo Richieste di ricerca al secondo nel servizio di ricerca |
SearchQueriesPerSecond |
No | CountPerSecond | Nella media | <nessuna> | PT1M | Sì |
|
Conteggio chiamate esecuzione competenza Numero di esecuzioni delle competenze |
SkillExecutionCount |
No | Conteggio | Totale (somma), numero di elementi |
DataSourceName, Failed, IndexerName, SkillName, SkillsetNameSkillType |
PT1M | Sì |
|
Percentuale query di ricerca limitate La percentuale di query di ricerca che sono state limitate per il servizio di ricerca |
ThrottledSearchQueriesPercentage |
No | Percentuale | Nella media | <nessuna> | PT1M | Sì |
Query di ricerca al secondo
Questa metrica mostra la media delle query di ricerca al secondo (QPS) per il servizio di ricerca. È comune che le query vengano eseguite in millisecondi, quindi solo le query che misurano come secondi vengono visualizzate in una metrica come QPS. Il valore minimo è il valore minimo per le query di ricerca al secondo registrate durante quel minuto. Il valore massimo è il valore più alto. Il valore medio è l'aggregato nel corso dell'intero minuto.
| Tipo di aggregazione | Descrizione |
|---|---|
| Nella media | Numero medio di secondi entro un minuto durante il quale si è verificata l'esecuzione della query. |
| Conteggio | Numero di metriche emesse nel log entro l'intervallo di un minuto. |
| Massimo | Numero massimo di query di ricerca al secondo registrate durante un minuto. |
| Minimo | Numero più basso di query di ricerca al secondo registrate in un minuto. |
| Somma | Somma di tutte le query eseguite entro il minuto. |
Ad esempio, entro un minuto, potrebbe essere presente un modello simile al seguente: un secondo di carico elevato che rappresenta il valore massimo per SearchQueriesPerSecond, seguito da 58 secondi di carico medio e infine un secondo con una sola query, che è il minimo.
Un altro esempio: se un nodo genera 100 metriche, dove il valore di ogni metrica è 40, "Count" è 100, "Sum" è 4000, "Average" è 40 e "Max" è 40.
Latenza di ricerca
La latenza di ricerca indica il tempo necessario per il completamento di una query.
| Tipo di aggregazione | Latenza |
|---|---|
| Nella media | Durata media della query in millisecondi. |
| Conteggio | Numero di metriche emesse nel log entro l'intervallo di un minuto. |
| Massimo | Query con esecuzione più lunga nell'esempio. |
| Minimo | Query con esecuzione più breve nell'esempio. |
| Totale | Tempo di esecuzione totale di tutte le query nel campione, eseguito entro l'intervallo di un minuto. |
Percentuale query di ricerca limitate
Questa metrica si riferisce alle query eliminate anziché elaborate. La limitazione si verifica quando il numero di richieste in fase di esecuzione supera la capacità. È possibile che si verifichi un aumento delle richieste soggette a limitazione quando una replica viene rimossa dalla rotazione o durante l'indicizzazione. Sia le richieste di query che di indicizzazione vengono gestite dallo stesso set di risorse.
Il servizio determina se eliminare le richieste in base all'utilizzo delle risorse. La percentuale di risorse utilizzate per memoria, CPU e I/O su disco viene calcolata in media per un periodo di tempo. Se questa percentuale supera una soglia, tutte le richieste all'indice vengono limitate fino a quando il volume delle richieste non viene ridotto.
A seconda del cliente, una richiesta limitata è indicata in questi modi:
- Un servizio restituisce un errore
"You are sending too many requests. Please try again later." - Un servizio restituisce un codice di errore 503 che indica che il servizio non è attualmente disponibile.
- Se si usa il portale di Azure (ad esempio Esplora ricerche), la query viene eliminata automaticamente ed è necessario selezionare di nuovo Search.
Per confermare le query di ricerca limitate, usare la metrica Query di ricerca limitate. È possibile esplorare le metriche nel portale di Azure o creare una metrica di avviso come descritto in questo articolo. Per le query eliminate entro l'intervallo di campionamento, usare Total per ottenere la percentuale di query che non sono state eseguite.
| Tipo di aggregazione | Limitazione |
|---|---|
| Nella media | Percentuale di query eliminate all'interno dell'intervallo. |
| Conteggio | Numero di metriche emesse nel log entro l'intervallo di un minuto. |
| Massimo | Percentuale di query eliminate all'interno dell'intervallo. |
| Minimo | Percentuale di query eliminate all'interno dell'intervallo. |
| Totale | Percentuale di query eliminate all'interno dell'intervallo. |
Per Throttled Search Queries Percentage, i valori minimo, massimo, medio e totale corrispondono tutti allo stesso valore: la percentuale di query di ricerca che sono state limitate, dal numero totale di query di ricerca nell'arco di un minuto.
Utilizzo delle unità di calcolo
Questa metrica misura le risorse di calcolo, memoria e I/O utilizzate dal servizio Azure AI Search, espresse in unità di calcolo milli (mCU). Funge da proxy per il costo di elaborazione di diversi tipi di operazione. L'utilizzo può variare nel tempo a seconda delle operazioni eseguite.
È possibile visualizzare questa metrica a due livelli:
- Livello di servizio di ricerca: consumo di calcolo aggregato nell'intero servizio.
- Livello di indice: l'ambito consumo è limitato a un indice specifico, utile per identificare gli indici che determinano la maggior parte dell'utilizzo delle risorse.
| Tipo di aggregazione | Descrizione |
|---|---|
| Sum | MCU totali utilizzati durante l'intervallo di tempo selezionato. Utile per comprendere i costi di calcolo complessivi nel tempo. |
| Media | Media mCU utilizzata durante l'intervallo di tempo selezionato. |
Questa metrica supporta i filtri seguenti:
Nome indice: filtra la metrica in un indice specifico. Se non viene applicato alcun filtro, la metrica riflette il consumo totale in tutti gli indici nel servizio.
Nome operazione: filtra la metrica in base all'operazione che contribuisce al consumo di calcolo. Se non viene applicato alcun filtro, la metrica riflette il consumo combinato in tutti i tipi di operazione. Per i valori supportati, vedere Informazioni di riferimento per i dati di monitoraggio.
Dimensioni delle metriche
Per informazioni su quali siano le dimensioni delle metriche, vedi Metriche multidimensionali.
Azure AI Search ha dimensioni associate alle seguenti metriche che registrano un conteggio di documenti o abilità eseguite.
| Nome della metrica | Descrizione | Dimensioni | Casi d'uso di esempio |
|---|---|---|---|
| Conteggio dei documenti elaborati | Mostra il numero di documenti elaborati dall'indicizzatore. | Nome dell'origine dati, non riuscito, nome dell'indice, nome dell'indicizzatore, nome del set di competenze | Può essere fatto riferimento come misura approssimativa della velocità effettiva (numero di documenti elaborati dall'indicizzatore nel tempo) - Configurare un avviso per i documenti con errori |
| Conteggio chiamate esecuzione competenza | Mostra il numero di invocazioni di abilità. | Nome dell'origine dati, non riuscito, nome dell'indice, nome dell'indicizzatore, nome della competenza, tipo di competenza, nome del set di abilità | Riferimento per garantire che le abilità vengano invocate come previsto confrontando i numeri di invocazione relativi tra abilità e il numero di invocazioni delle abilità in rapporto al numero di documenti. - Configurare l'avviso per le invocazioni di skill non riuscite |
| Utilizzo delle unità di calcolo | Mostra le unità mCU utilizzate dalle operazioni nel servizio di ricerca | Nome dell'indice, Operazione | Valutare quale operazione ha utilizzato il maggior numero di risorse di calcolo. -Configurare avvisi quando il consumo di materiale di scavo supera le soglie previste per un determinato tipo di operazione |
| Nome della dimensione | Descrizione |
|---|---|
| DataSourceName | Connessione all'origine dati denominata utilizzata durante l'esecuzione dell'indicizzatore. I valori validi sono uno dei tipi di origine dati supportati. |
| Fallito | Indica se l'istanza non è riuscita. |
| IndexerName | Nome di un indicizzatore. |
| IndexName | Nome di un indice. |
| SkillsetName | Nome di un set di competenze usato durante l'esecuzione dell'indicizzatore. |
| SkillName | Nome di una competenza all'interno di un set di competenze. |
| TipoDiAbilità | Il @odata.type della competenza. |
Log delle risorse
Questa sezione elenca i tipi di log delle risorse che puoi raccogliere per questo servizio. La sezione estrae dall'elenco di tutti i tipi di categoria dei log delle risorse supportati in Monitoraggio di Azure.
Log di risorse supportati per Microsoft Search/searchServices
| Categoria | Costi di esportazione | Tabella dei log | Supporta un piano di registrazione base | Supporta la trasformazione del tempo di ingestione | Query di esempio |
|---|---|---|---|---|---|
| OperationLogs | No |
AzureDiagnostics Log da più risorse Azure. |
No | No |
Tabelle di Monitoraggio di Azure Logs
Questa sezione elenca le tabelle Monitoraggio di Azure Logs rilevanti per questo servizio, che sono disponibili per la query da parte di Log Analytics tramite Kusto queries. Le tabelle contengono dati di log delle risorse e possibilmente anche di più, a seconda di ciò che viene raccolto e instradato ad esse.
Servizi di ricerca
Microsoft.Search/searchServices
| Tabella | Descrizione |
|---|---|
| AzureActivity | Le voci del log attività Azure forniscono informazioni dettagliate sulle operazioni del piano di controllo. Le attività richiamate sul piano di controllo, ad esempio l'aggiunta o la rimozione di repliche e partizioni, vengono rappresentate tramite un'attività "Get Admin Key". |
| AzureDiagnostics | Operazioni di query e indicizzazione registrate. Le query sulla tabella AzureDiagnostics in Log Analytics possono includere le proprietà comuni, le proprietà specifiche di search e le operazioni specifiche di search elencate nella sezione di riferimento dello schema. |
| AzureMetrics | Dati delle metriche generati da Azure AI Search che misurano lo stato e le prestazioni. |
Tabelle dei log delle risorse
Nella tabella seguente sono elencate le proprietà dei log delle risorse in Azure AI Search. I log delle risorse vengono raccolti in Monitoraggio di Azure log o Archiviazione di Azure. In Monitoraggio di Azure i log vengono raccolti nella tabella AzureDiagnostics sotto il nome del provider di risorse Microsoft.Search.
| Archiviazione di Azure campo o proprietà | Proprietà dei log di Monitoraggio di Azure | Descrizione |
|---|---|---|
| Tempo | TIMESTAMP | Data e ora (UTC) in cui si è verificata l'operazione. |
| resourceId | Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) | Risorsa Azure AI Search per cui sono abilitati i log. |
| Categoria | "OperationLogs" | Le categorie di log includono Audit, Operational, Executione Request. |
| Nome operazione | Nome | Nome dell'operazione. Il nome dell'operazione può essere Indexes.ListIndexStatsSummaries, Indexes.Get, Indexes.Stats, Indexers.List, Query.Search, Query.Suggest, Query.Lookup, Query.Autocomplete, CORS.Preflight, Indexes.Update, Indexes.Prototype, ServiceStats, DataSources.List, Indexers.Warmup. |
| durata in millisecondi | Durata in millisecondi | Durata dell'operazione, espressa in millisecondi. |
| operationVersion | ApiVersion | Versione dell'API usata nella richiesta. |
| tipo di risultato | (Non riuscito) ? "Fallito" : "Successo" | Tipo di risposta. |
| resultSignature | Stato | Stato della risposta HTTP dell'operazione. |
| Proprietà | Proprietà | Eventuali proprietà estese correlate a questa categoria di eventi. |
Log attività
La tabella collegata elenca le operazioni che possono essere registrate nel registro attività per questo servizio. Queste operazioni sono un sottoinsieme di tutte le possibili operazioni del fornitore di risorse nel registro attività.
Per ulteriori informazioni sullo schema delle voci del registro delle attività, vedi Schema del registro delle attività.
Nella tabella seguente sono elencate le operazioni comuni correlate alle Azure AI Search che possono essere registrate nel log attività. Per un elenco completo di tutte le operazioni di Microsoft Search, vedere operazioni del provider di risorse di Microsoft Search.
| Operazione | Descrizione |
|---|---|
| Ottenere la chiave di amministratore | Qualsiasi operazione che richiede diritti amministrativi viene registrata come operazione "Get Admin Key". |
| Ottenere la chiave di query | Qualsiasi operazione di sola lettura sulla collezione di documenti di un indice. |
| Rigenerare la chiave di amministrazione | Richiesta di rigenerazione della chiave API amministratore primaria o secondaria. |
Le voci comuni includono riferimenti alle chiavi API: notifiche generiche informative come Get Admin Key (Ottieni chiave di amministrazione ) e Get Query keys (Ottieni chiavi di query). Queste attività indicano le richieste effettuate usando la chiave di amministrazione (creare o eliminare oggetti) o la chiave di query, ma non visualizzare la richiesta stessa. Per informazioni su questo livello di dettaglio, è necessario configurare la registrazione delle risorse.
In alternativa, è possibile ottenere informazioni dettagliate tramite la cronologia delle modifiche. Nel portale di Azure selezionare l'attività per aprire la pagina dei dettagli e quindi selezionare "Cronologia modifiche" per informazioni sull'operazione sottostante.
Altri schemi
Per questo servizio sono in uso gli schemi seguenti.
Se si creano query o report personalizzati, le strutture di dati che contengono i log delle risorse di Azure AI Search sono conformi agli schemi seguenti.
Per i log delle risorse inviati all'archivio BLOB, ogni BLOB ha un oggetto radice denominato record contenente una matrice di oggetti di log. Ogni BLOB contiene record per tutte le operazioni eseguite durante la stessa ora.
Schema del log delle risorse
Tutti i log delle risorse disponibili tramite Monitoraggio di Azure condividono uno schema di primo livello comune. Azure AI Search fornisce più proprietà e operazioni univoche per un servizio di ricerca.
Nell'esempio seguente viene illustrato un log delle risorse che include proprietà comuni (TimeGenerated, Resource, Category e così via) e proprietà specifiche della ricerca (OperationName e OperationVersion).
| Nome | Digitare | Descrizione ed esempio |
|---|---|---|
| TimeGenerated | Data e ora | Timestamp dell'operazione. Ad esempio: 2021-12-07T00:00:43.6872559Z |
| Risorsa | Stringa | ID risorsa. Ad esempio: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name> |
| Categoria | Stringa | "OperationLogs". Questo valore è una costante. OperationLogs è l'unica categoria usata per i log delle risorse. |
| NomeOperazione | Stringa | Nome dell'operazione (vedere l'elenco completo delle operazioni). Un esempio è Query.Search |
| OperationVersion | Stringa | Versione api usata nella richiesta. Ad esempio: 2026-04-01 |
| ResultType | Stringa | "Operazione riuscita". Altri valori possibili: Operazione riuscita o Errore |
| ResultSignature | Int | Codice del risultato HTTP. Ad esempio: 200 |
| DurationMS | Int | Durata dell'operazione in millisecondi. |
| Proprietà | Oggetto | Oggetto contenente dati specifici dell'operazione. Vedere la tabella dello schema delle proprietà seguente. |
Schema delle proprietà
Le proprietà seguenti sono specifiche per Azure AI Search.
| Nome | Digitare | Descrizione ed esempio |
|---|---|---|
| Description_s | Stringa | Endpoint dell'operazione. Ad esempio: GET /indexes('content')/docs |
| Documents_d | Int | Numero di documenti elaborati. |
| IndexName_s | Stringa | Nome dell'indice associato all'operazione. |
| Query_s | Stringa | Parametri di query usati nella richiesta. Ad esempio: ?search=beach access&$count=true&api-version=2026-04-01 |
Valori operationName (operazioni registrate)
Le operazioni seguenti possono essere visualizzate in un log delle risorse.
| NomeOperazione | Descrizione |
|---|---|
| DataSources.* | Si applica alle origini dati degli indicizzatori. Può essere Crea, Elimina, Ottieni, Elenca. |
| DebugSessions.* | Si applica a una sessione di debug. Può essere Crea, Elimina, Ottieni, Elenco, Avvia e Stato. |
| DebugSessions.DocumentStructure | Un documento arricchito viene caricato in una sessione di debug. |
| DebugSessions.RetrieveIndexerExecutionHistoricalData | Richiesta di dettagli sull'esecuzione dell'indicizzatore. |
| DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData | Cronologia di esecuzione per gli arricchimenti proiettati in un archivio di conoscenza. |
| Indicizzatori.* | Si applica a un indicizzatore. Può essere Create, Delete, Get, List e Status. |
| Indici.* | Si applica a un indice di ricerca. Può essere Crea, Elimina, Ottieni, Elenca. |
| indexes.Prototype | I metadati dell'indice vengono definiti dalla procedura guidata Importa dati in base agli input di dati. |
| Indicizzazione.Indice | Questa operazione è una chiamata a Index Documents.This operation is a call to Index Documents. |
| Metadata.GetMetadata | Richiesta di dati di sistema del servizio di ricerca. |
| Query.Autocomplete | Query di completamento automatico su un indice. Vedere Tipi di query e composizione. |
| Query.Lookup | Query di ricerca su un indice. Vedere Tipi di query e composizione. |
| Query.Search | Richiesta di ricerca full-text su un indice. Vedere Tipi di query e composizione. |
| Query.Suggest | Query di completamento automatico su un indice. Vedere Tipi di query e composizione. |
| ServiceStats | Questa operazione è una chiamata di routine a Get Service Statistics, chiamata direttamente o implicitamente per popolare una pagina di panoramica del portale quando viene caricata o aggiornata. |
| Set di competenze.* | Si applica a un insieme di competenze. Può essere Crea, Elimina, Ottieni, Elenca. |
Contenuto correlato
- Per una descrizione delle Azure AI Search di monitoraggio, vedere Monitor Azure AI Search.
- Vedi Monitora Azure risorse con Monitoraggio di Azure per dettagli sul monitoraggio Azure risorse.