Riferimento ai dati di monitoraggio di Azure AI Search
Questo articolo contiene tutte le informazioni di riferimento sul monitoraggio per questo servizio.
Vedere Monitorare Ricerca intelligenza artificiale di Azure per informazioni dettagliate sui dati che è possibile raccogliere per Ricerca di intelligenza artificiale di Azure e su come usarli.
Metrica
Questa sezione elenca tutte le metriche della piattaforma raccolte automaticamente per questo servizio. Queste metriche fanno anche parte dell'elenco globale di tutte le metriche della piattaforma supportate nel Monitoraggio di Azure.
Per informazioni sulla conservazione delle metriche, vedere Informazioni generali sulle metriche del Monitoraggio di Azure.
Metriche supportate per Microsoft.Search/searchServices
La tabella seguente elenca le metriche disponibili per il tipo di risorsa Microsoft.Search/searchServices.
- Potrebbero non essere presenti tutte le colonne in ogni tabella.
- Alcune colonne potrebbero superare l'area di visualizzazione della pagina. Selezionare Espandi tabella per visualizzare tutte le colonne disponibili.
Intestazioni di tabella
- Categoria: gruppo o classificazione delle metriche.
- Metrica: nome visualizzato della metrica come visualizzato nella portale di Azure.
- Nome nell'API REST: nome della metrica indicato nell'API REST.
- Unità: Unità di misura.
- Aggregazione: tipo di aggregazione predefinito. Valori validi: Medio (Avg), Minimo (Min), Massimo (Max), Totale (Sum), Conteggio.
- Dimensioni - Dimensioni disponibili per la metrica.
- Intervalli di tempo - Intervalli in cui viene campionata la metrica. Ad esempio,
PT1Mindica che la metrica viene campionata ogni minuto,PT30Mogni 30 minuti,PT1Hogni ora e così via. - Esportazione DS: indica se la metrica è esportabile nei log di Monitoraggio di Azure tramite le impostazioni di diagnostica. Per informazioni sull'esportazione delle metriche, vedere Creare impostazioni di diagnostica nel Monitoraggio di Azure.
| Metric | Nome nell'API REST | Unità | Aggregazione | Dimensioni | Intervalli di tempo | Esportazione DS |
|---|---|---|---|---|---|---|
| Conteggio dei documenti elaborati Numero di documenti elaborati |
DocumentsProcessedCount |
Count | Totale (somma), conteggio | DataSourceName, Failed, IndexerName, IndexNameSkillsetName |
PT1M | Sì |
| Latenza di ricerca La latenza di ricerca media per il servizio di ricerca |
SearchLatency |
Secondi | Media | <none> | PT1M | Sì |
| Query di ricerca al secondo Le query di ricerca al secondo per il servizio di ricerca |
SearchQueriesPerSecond |
Conteggio al secondo | Media | <none> | PT1M | Sì |
| Conteggio delle chiamate di esecuzione delle competenze Numero di esecuzioni di competenze |
SkillExecutionCount |
Count | Totale (somma), conteggio | 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 |
Percentuale | Media | <none> | 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. La media è l'aggregazione nell'intero minuto.
| Tipo di aggregazione | Descrizione |
|---|---|
| Media | Numero medio di secondi entro un minuto durante il quale si è verificata l'esecuzione della query. |
| Count | Numero di metriche generate 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 durante un minuto. |
| Sum | 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 ricerca
La latenza di ricerca indica il tempo necessario per il completamento di una query.
| Tipo di aggregazione | Latenza |
|---|---|
| Media | Durata media della query in millisecondi. |
| Count | Numero di metriche generate 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 nell'esempio, in esecuzione entro l'intervallo (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 nell'esecuzione supera la capacità. È possibile che si verifichi un aumento delle richieste limitate quando una replica viene estratta 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 client, 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 Cerca.
Per confermare le query 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 |
|---|---|
| Media | Percentuale di query eliminate entro l'intervallo. |
| Count | Numero di metriche generate nel log entro l'intervallo di un minuto. |
| Massimo | Percentuale di query eliminate entro l'intervallo. |
| Minimo | Percentuale di query eliminate entro l'intervallo. |
| Totale | Percentuale di query eliminate entro l'intervallo. |
Per Le query di ricerca limitate Percentuale, minimo, massimo, medio e totale hanno lo stesso valore: la percentuale di query di ricerca limitate, dal numero totale di query di ricerca durante un minuto.
Dimensioni delle metriche
Per informazioni sulle dimensioni delle metriche, vedere Metriche multidimensionali.
Ricerca di intelligenza artificiale di Azure include dimensioni associate alle metriche seguenti che acquisiscono un conteggio di documenti o competenze eseguiti.
| Nome metrica | Descrizione | Dimensioni | Casi d'uso di esempio |
|---|---|---|---|
| Conteggio dei documenti elaborati | Mostra il numero di documenti elaborati dall'indicizzatore. | Nome origine dati, non riuscito, nome dell'indice, nome dell'indicizzatore, nome set di competenze | Può essere fatto riferimento come misura approssimativa della velocità effettiva (numero di documenti elaborati dall'indicizzatore nel tempo) - Configurare l'avviso per i documenti non riusciti |
| Conteggio delle chiamate di esecuzione delle competenze | Mostra il numero di chiamate di competenza. | Nome origine dati, non riuscito, nome dell'indice, nome indicizzatore, nome della competenza, tipo di competenza, nome set di competenze | Riferimento per garantire che le competenze vengano richiamate come previsto confrontando i numeri di chiamata relativi tra le competenze e il numero di chiamate di competenza al numero di documenti. - Configurare l'avviso per le chiamate di competenza non riuscite |
| 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. |
| Non riuscito | 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. |
| SkillType | Oggetto @odata.type della competenza. |
Log risorse
Questa sezione elenca i tipi di log delle risorse che si possono raccogliere per questo servizio. La sezione esegue il pull dall'elenco di tutti i tipi di categoria dei log delle risorse supportati nel Monitoraggio di Azure.
Log delle risorse supportati per Microsoft.Search/searchServices
| Categoria | Nome visualizzato della categoria | Tabella di log | Supporta il piano di log di base | Supporta la trasformazione in fase di inserimento | Query di esempio | Costi da esportare |
|---|---|---|---|---|---|---|
OperationLogs |
Log delle operazioni | AzureDiagnostics Log da più risorse di Azure. |
No | No | No |
Tabelle di log di Monitoraggio di Azure
Questa sezione elenca tutte le tabelle dei log del Monitoraggio di Azure pertinenti a questo servizio che sono disponibili per la query da parte di Log Analytics mediante le query di Kusto. Le tabelle contengono i dati dei log delle risorse ed eventualmente altro, a seconda di ciò che viene raccolto e indirizzato verso di esse.
Servizi di ricerca
Microsoft.Search/searchServices
| Tabella | Descrizione |
|---|---|
| AzureActivity | Le voci del log attività di 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 della ricerca e le operazioni specifiche della ricerca elencate nella sezione di riferimento allo schema. |
| AzureMetrics | Dati delle metriche generati da Ricerca di intelligenza artificiale di Azure che misurano l'integrità e le prestazioni. |
Tabelle dei log delle risorse
La tabella seguente elenca le proprietà dei log delle risorse in Ricerca di intelligenza artificiale di Azure. I log delle risorse vengono raccolti nei log di Monitoraggio di Azure o in Archiviazione di Azure. In Monitoraggio di Azure i log vengono raccolti nella tabella AzureDiagnostics sotto il nome del provider di risorse .Microsoft.Search
| Proprietà o campo di Archiviazione di Azure | Proprietà dei log di Monitoraggio di Azure | Descrizione |
|---|---|---|
| Ora | TIMESTAMP | Data e ora (UTC) in cui si è verificata l'operazione. |
| resourceId | Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) | Risorsa di Ricerca di intelligenza artificiale di Azure per cui sono abilitati i log. |
| category | "OperationLogs" | Le categorie di log includono Audit, Operational, Executione Request. |
| operationName | Nome | Nome dell'operazione. Il nome dell'operazione può essere , , Indexers.List, , , Query.Autocomplete. CORS.PreflightIndexers.WarmupIndexes.PrototypeDataSources.ListIndexes.UpdateQuery.SuggestQuery.LookupServiceStatsQuery.SearchIndexes.StatsIndexes.GetIndexes.ListIndexStatsSummaries |
| durationMS | DurationMilliseconds | La durata dell'operazione in millisecondi. |
| operationVersion | ApiVersion | Versione dell'API usata nella richiesta. |
| resultType | (Non riuscito) ? "Failed" : "Success" | Tipo di risposta. |
| resultSignature | Status | Stato della risposta HTTP dell'operazione. |
| proprietà | Proprietà | Eventuali proprietà estese correlate a questa categoria di eventi. |
Log attività
Nella tabella collegata sono elencate le operazioni che possono essere registrate nel log attività per questo servizio. Queste operazioni sono un sottoinsieme di tutte le possibili operazioni del provider di risorse nel log attività.
Per altre informazioni sullo schema delle voci del log attività, vedere Schema del log attività.
La tabella seguente elenca le operazioni comuni correlate a Ricerca di intelligenza artificiale di Azure che possono essere registrate nel log attività. Per un elenco completo di tutte le operazioni di Microsoft.Search, vedere Operazioni del provider di risorse 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 sull'insieme documents di un indice. |
| Rigenerare la chiave amministratore | 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 tipo di dettaglio, è necessario configurare la registrazione delle risorse.
In alternativa, è possibile ottenere informazioni dettagliate tramite la cronologia delle modifiche. Nella 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 Ricerca intelligenza artificiale di Azure 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 su tutte le operazioni eseguite nell'arco della stessa ora.
Schema del log delle risorse
Tutti i log delle risorse disponibili tramite Monitoraggio di Azure condividono uno schema di primo livello comune. Ricerca di intelligenza artificiale di Azure integra con 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 | Type | Descrizione ed esempio |
|---|---|---|
| TimeGenerated | Datetime | Timestamp dell'operazione. Ad esempio: 2021-12-07T00:00:43.6872559Z |
| Conto risorse | String | ID risorsa. Ad esempio: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name> |
| Categoria | String | "OperationLogs". Questo valore è una costante. OperationLogs è l'unica categoria usata per i log delle risorse. |
| OperationName | String | Nome dell'operazione (vedere l'elenco completo delle operazioni). Un esempio è Query.Search |
| OperationVersion | String | Versione api usata nella richiesta. Ad esempio: 2024-07-01 |
| ResultType | String | "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à | Object | Oggetto contenente dati specifici dell'operazione. Vedere la tabella dello schema delle proprietà seguente. |
Schema delle proprietà
Le proprietà seguenti sono specifiche di Ricerca di intelligenza artificiale di Azure.
| Nome | Type | Descrizione ed esempio |
|---|---|---|
| Description_s | String | Endpoint dell'operazione. Ad esempio: GET /indexes('content')/docs |
| Documents_d | Int | Numero di documenti elaborati. |
| IndexName_s | String | Nome dell'indice associato all'operazione. |
| Query_s | String | Parametri di query usati nella richiesta. Ad esempio: ?search=beach access&$count=true&api-version=2024-07-01 |
Valori operationName (operazioni registrate)
Le operazioni seguenti possono essere visualizzate in un log delle risorse.
| OperationName | Descrizione |
|---|---|
| DataSources.* | Si applica alle origini dati dell'indicizzatore. Può essere Create, Delete, Get, List. |
| DebugSessions.* | Si applica a una sessione di debug. Può essere Create, Delete, Get, List, Start e Status. |
| DebugSessions.DocumentStructure | Un documento arricchito viene caricato in una sessione di debug. |
| DebugSessions.RetrieveIndexerExecutionExecutionExecutionData | Richiesta di dettagli sull'esecuzione dell'indicizzatore. |
| DebugSessions.RetrieveProjectedIndexerExecutionProjectData | Cronologia di esecuzione per gli arricchimenti proiettati in un archivio conoscenze. |
| Indicizzatori.* | Si applica a un indicizzatore. Può essere Create, Delete, Get, List e Status. |
| Indici.* | Si applica a un indice di ricerca. Può essere Create, Delete, Get, List. |
| Indici. Prototipo | Questo indice viene creato dalla procedura guidata Importa dati. |
| Indexing.Index | 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 | Digitare in anticipo una query 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 set di competenze. Può essere Create, Delete, Get, List. |
Contenuto correlato
- Vedere Monitorare Ricerca intelligenza artificiale di Azure per una descrizione del monitoraggio di Ricerca di intelligenza artificiale di Azure.
- Per informazioni dettagliate sul monitoraggio delle risorse di Azure, vedere Monitora le risorse di Azure con il Monitoraggio di Azure.