Monitoraggio di un servizio di Ricerca di AzureMonitoring an Azure Search service

Ricerca di Azure offre varie risorse per tenere traccia dell'utilizzo e delle prestazioni dei servizi di ricerca.Azure Search offers various resources for tracking usage and performance of search services. Consente di accedere a metriche, log, statistiche di indice e funzionalità estese di monitoraggio in Power BI.It gives you access to metrics, logs, index statistics, and extended monitoring capabilities on Power BI. L'articolo descrive come abilitare le diverse strategie di monitoraggio e come interpretare i dati risultanti.This article describes how to enable the different monitoring strategies and how to interpret the resulting data.

Metriche di Ricerca di AzureAzure Search metrics

Le metriche offrono una visibilità quasi in tempo reale nel servizio di ricerca e sono disponibili per ogni servizio, senza alcuna impostazione aggiuntiva.Metrics give you near real-time visibility into your search service and are available for every service, with no additional setup. Consentono di tenere traccia delle prestazioni del servizio fino a 30 giorni.They let you track the performance of your service for up to 30 days.

Ricerca di Azure raccoglie i dati per tre metriche diverse:Azure Search collects data for three different metrics:

  • Latenza ricerca: tempo necessario al servizio di ricerca per elaborare le query di ricerca, aggregate per minuto.Search latency: Time the search service needed to process search queries, aggregated per minute.
  • Query di ricerca al secondo: numero di query di ricerca ricevute al secondo, aggregate per minuto.Search queries per second (QPS): Number of search queries received per second, aggregated per minute.
  • Percentuale query di ricerca limitate: percentuale di query di ricerca che sono state limitate, aggregate per minuto.Throttled search queries percentage: Percentage of search queries that were throttled, aggregated per minute.

Screenshot dell'attività delle query al secondo

Impostare gli avvisiSet up alerts

Dalla pagina di dettaglio relativa alle metriche è possibile configurare gli avvisi per attivare una notifica di posta elettronica o un'azione automatica quando una metrica non rispetta un limite definito.From the metric detail page, you can configure alerts to trigger an email notification or an automated action when a metric crosses a threshold that you have defined.

Per altre informazioni sulle metriche, vedere la documentazione completa su Monitoraggio di Azure.For more information about metrics, check the full documentation on Azure Monitor.

Come tenere traccia dell'utilizzo delle risorseHow to track resource usage

Il controllo dell'aumento degli indici e delle dimensioni del documento consente di regolare in modo proattivo la capacità prima di raggiungere il limite massimo stabilito per il servizio.Tracking the growth of indexes and document size can help you proactively adjust capacity before hitting the upper limit you've established for your service. È possibile eseguire questa operazione nel portale o a livello di codice tramite l'API REST.You can do this on the portal or programmatically using the REST API.

Tramite il portaleUsing the portal

Per monitorare l'uso delle risorse, visualizzare i conteggi e le statistiche per il servizio nel portale.To monitor resource usage, view the counts and statistics for your service in the portal.

  1. Accedere al portale.Sign in to the portal.
  2. Aprire il dashboard relativo al servizio Ricerca di Azure.Open the service dashboard of your Azure Search service. Nella Home page sono presenti riquadri per il servizio oppure è possibile accedere al servizio tramite Sfoglia nell'indice.Tiles for the service can be found on the Home page, or you can browse to the service from Browse on the JumpBar.

La sezione Utilizzo include un indicatore che indica la quantità di risorse disponibili attualmente in uso.The Usage section includes a meter that tells you what portion of available resources are currently in use. Per informazioni sui limiti dei servizi per indici, documenti e archiviazione, vedere Limiti dei servizi.For information on per-service limits for indexes, documents, and storage, see Service limits.

Riquadro Utilizzo

Nota

Lo screenshot precedente si riferisce al servizio gratuito, che offre una sola replica e una partizione e può ospitare solo 3 indici, 10.000 documenti o 50 MB di dati, a seconda di quale di queste condizioni si verifichi per prima.The screenshot above is for the Free service, which has a maximum of one replica and partition each, and can only host 3 indexes, 10,000 documents, or 50 MB of data, whichever comes first. I servizi creati con piano Basic o Standard hanno limiti più elevati.Services created at a Basic or Standard tier have much larger service limits. Per altre informazioni sulla scelta di un piano, vedere Scegliere uno SKU o un piano.For more information on choosing a tier, see Choose a tier or SKU.

Utilizzo dell'API RESTUsing the REST API

L'API REST di Ricerca di Azure e .NET SDK forniscono l'accesso a livello di codice alle metriche di servizio.Both the Azure Search REST API and the .NET SDK provide programmatic access to service metrics. Se si usano indicizzatori per caricare un indice dal database SQL di Azure o da Azure Cosmos DB, è disponibile un'API aggiuntiva per ottenere i numeri necessari.If you are using indexers to load an index from Azure SQL Database or Azure Cosmos DB, an additional API is available to get the numbers you require.

Come esportare i log e le metricheHow to export logs and metrics

È possibile esportare i log delle operazioni per il servizio e i dati non elaborati per le metriche descritte nella sezione precedente.You can export the operation logs for your service and the raw data for the metrics described in the preceding section. I log operazioni mostrano il modo in cui il servizio viene usato e in che modo può essere usato da Power BI quando si copiano dati in un account di archiviazione.Operation logs let you know how the service is being used and can be consumed from Power BI when data is copied to a storage account. Ricerca di Azure include per questo scopo un pacchetto di contenuti Power BI per il monitoraggio.Azure search provides a monitoring Power BI content pack for this purpose.

Abilitazione del monitoraggioEnabling monitoring

Aprire il servizio Ricerca di Azure nel portale di Azure sotto l'opzione Abilita monitoraggio.Open your Azure Search service in the Azure portal under the Enable Monitoring option.

Scegliere i dati da esportare: log, metriche o entrambi.Choose the data you want to export: Logs, Metrics or both. È possibile copiare i dati in un account di archiviazione, inviarli a un hub eventi o esportarli in Log Analytics.You can copy it to a storage account, send it to an event hub or export it to Log Analytics.

Come abilitare il monitoraggio nel portale

Per abilitare il monitoraggio tramite PowerShell o l'interfaccia della riga di comando di Azure, vedere la documentazione qui.To enable using PowerShell or the Azure CLI, see the documentation here.

Schemi di log e di metricheLogs and metrics schemas

I dati che vengono copiati in un account di archiviazione vengono formattati come JSON e inseriti in due contenitori:When the data is copied to a storage account, the data is formatted as JSON and it's place in two containers:

  • insights-logs-operationlogs: per i log relativi al traffico ricercainsights-logs-operationlogs: for search traffic logs
  • insights-metrics-pt1m: per le metricheinsights-metrics-pt1m: for metrics

È presente un BLOB ogni ora per ciascun contenitore.There is one blob, per hour, per container.

Percorso di esempio: resourceId=/subscriptions/<subscriptionID>/resourcegroups/<resourceGroupName>/providers/microsoft.search/searchservices/<searchServiceName>/y=2015/m=12/d=25/h=01/m=00/name=PT1H.jsonExample path: resourceId=/subscriptions/<subscriptionID>/resourcegroups/<resourceGroupName>/providers/microsoft.search/searchservices/<searchServiceName>/y=2015/m=12/d=25/h=01/m=00/name=PT1H.json

Schema del logLog schema

I BLOB dei log contengono i log di traffico del servizio di ricerca.The logs blobs contain your search service traffic logs. Ogni BLOB ha un oggetto radice denominato record che contiene una matrice di oggetti di log.Each blob has one root object called records that contains an array of log objects. Ogni BLOB contiene record su tutte le operazioni eseguite nell'arco della stessa ora.Each blob has records on all the operation that took place during the same hour.

NomeName TipoType EsempioExample NoteNotes
timetime datetimedatetime "2015-12-07T00:00:43.6872559Z""2015-12-07T00:00:43.6872559Z" Timestamp dell'operazioneTimestamp of the operation
resourceIdresourceId stringstring "/SUBSCRIPTIONS/11111111-1111-1111-1111-111111111111/"/SUBSCRIPTIONS/11111111-1111-1111-1111-111111111111/
RESOURCEGROUPS/DEFAULT/PROVIDERS/RESOURCEGROUPS/DEFAULT/PROVIDERS/
MICROSOFT.SEARCH/SEARCHSERVICES/SEARCHSERVICE"MICROSOFT.SEARCH/SEARCHSERVICES/SEARCHSERVICE"
resourceId in usoYour ResourceId
operationNameoperationName stringstring "Query.Search""Query.Search" Nome dell'operazioneThe name of the operation
operationVersionoperationVersion stringstring "2015-02-28""2015-02-28" api-version usataThe api-version used
categorycategory stringstring "OperationLogs""OperationLogs" costanteconstant
resultTyperesultType stringstring "Esito positivo""Success" Valori possibili: esito positivo o negativoPossible values: Success or Failure
resultSignatureresultSignature intint 200200 Codice risultato HTTPHTTP result code
durationMSdurationMS intint 5050 Durata dell'operazione in millisecondiDuration of the operation in milliseconds
propertiesproperties objectobject Vedere la tabella seguentesee the following table Oggetto contenente dati specifici dell'operazioneObject containing operation-specific data

Schema delle proprietàProperties schema

NomeName TipoType EsempioExample NoteNotes
DescrizioneDescription stringstring "GET /indexes('content')/docs""GET /indexes('content')/docs" Endpoint dell'operazioneThe operation's endpoint
QueryQuery stringstring "?search=AzureSearch&$count=true&api-version=2015-02-28""?search=AzureSearch&$count=true&api-version=2015-02-28" Parametri della queryThe query parameters
DocumentiDocuments intint 4242 Numero di documenti elaboratiNumber of documents processed
IndexNameIndexName stringstring "testindex""testindex" Nome dell'indice associato all'operazioneName of the index associated with the operation

Schema delle metricheMetrics schema

NomeName TipoType EsempioExample NoteNotes
resourceIdresourceId stringstring "/SUBSCRIPTIONS/11111111-1111-1111-1111-111111111111/"/SUBSCRIPTIONS/11111111-1111-1111-1111-111111111111/
RESOURCEGROUPS/DEFAULT/PROVIDERS/RESOURCEGROUPS/DEFAULT/PROVIDERS/
MICROSOFT.SEARCH/SEARCHSERVICES/SEARCHSERVICE"MICROSOFT.SEARCH/SEARCHSERVICES/SEARCHSERVICE"
ID risorsa in usoyour resource id
metricNamemetricName stringstring "Latenza""Latency" Nome della metricathe name of the metric
timetime datetimedatetime "2015-12-07T00:00:43.6872559Z""2015-12-07T00:00:43.6872559Z" Timestamp dell'operazionethe operation's timestamp
averageaverage intint 6464 Valore medio degli esempi non elaborati nell'intervallo di tempo della metricaThe average value of the raw samples in the metric time interval
minimumminimum intint 3737 Valore minimo degli esempi non elaborati nell'intervallo di tempo della metricaThe minimum value of the raw samples in the metric time interval
maximummaximum intint 7878 Valore massimo degli esempi non elaborati nell'intervallo di tempo della metricaThe maximum value of the raw samples in the metric time interval
totaltotal intint 258258 Valore totale degli esempi non elaborati nell'intervallo di tempo della metricaThe total value of the raw samples in the metric time interval
countcount intint 44 Numero degli esempi non elaborati usati per generare la metricaThe number of raw samples used to generate the metric
timegraintimegrain stringstring "PT1M""PT1M" Intervallo di tempo della metrica nel formato ISO 8601The time grain of the metric in ISO 8601

Tutte le metriche vengono segnalate in intervalli di un minuto.All metrics are reported in one-minute intervals. Ogni metrica espone i valori minimi, massimi e medi al minuto.Every metric exposes minimum, maximum and average values per minute.

Per la metrica SearchQueriesPerSecond, il valore minimo è quello più basso per le query di ricerca al secondo registrato durante questo minuto.For the SearchQueriesPerSecond metric, minimum is the lowest value for search queries per second that was registered during that minute. Lo stesso vale anche per il valore massimo.The same applies to the maximum value. Il valore medio è l'aggregato nel corso dell'intero minuto.Average, is the aggregate across the entire minute. Considerare questo scenario nell'arco di un minuto: un secondo di carico elevato, che è il valore massimo per SearchQueriesPerSecond, seguito da 58 secondi di carico medio e infine da un secondo con una sola query, che è il valore minimo.Think about this scenario during one minute: one second of high load that is the maximum for SearchQueriesPerSecond, followed by 58 seconds of average load, and finally one second with only one query, which is the minimum.

Per ThrottledSearchQueriesPercentage, 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.For ThrottledSearchQueriesPercentage, minimum, maximum, average and total, all have the same value: the percentage of search queries that were throttled, from the total number of search queries during one minute.

Analisi dei dati con Power BIAnalyzing your data With Power BI

Si consiglia di usare Power BI per esplorare e visualizzare i dati.We recommend using Power BI to explore and visualize your data. È possibile connettersi facilmente all'account di Archiviazione di Azure e avviare rapidamente l'analisi dei dati.You can easily connect it to your Azure Storage Account and quickly start analyzing your data.

Ricerca di Azure include un pacchetto di contenuti Power BI che consente di monitorare ed esaminare il traffico delle ricerche attraverso tabelle e grafici predefiniti.Azure Search provides a Power BI Content Pack that allows you to monitor and understand your search traffic with predefined charts and tables. Il pacchetto contiene un set di report Power BI che si connettono automaticamente ai dati e forniscono informazioni visive dettagliate sul servizio di ricerca.It contains a set of Power BI reports that automatically connect to your data and provide visual insights about your search service. Per altre informazioni, vedere la pagina della Guida del pacchetto di contenuti.For more information, see the content pack help page.

Dashboard di Power BI per Ricerca di Azure

Passaggi successiviNext steps

Rivedere Limiti dei servizi in Ricerca di Azure per indicazioni su come bilanciare l'allocazione delle partizioni e delle repliche per un servizio esistente.Review Scale replicas and partitions for guidance on how to balance the allocation of partitions and replicas for an existing service.

Visitare Amministrazione del servizio per Ricerca di Azure nel portale di Azure per altre informazioni sull'amministrazione del servizio o Prestazioni e ottimizzazione per indicazioni sull'ottimizzazione.Visit Manage your Search service on Microsoft Azure for more information on service administration, or Performance and optimization for tuning guidance.

Altre informazioni sulla creazione di report utiliLearn more about creating amazing reports. Per informazioni dettagliate, vedere Introduzione a Power BI Desktop.See Getting started with Power BI Desktop for details