Registrazione di Azure Data Manager per l'agricoltura

Dopo aver creato un'istanza di risorsa data manager per l'agricoltura, è possibile monitorare come e quando si accede alle risorse e da chi. È anche possibile eseguire il debug per motivi di errore per le richieste del piano dati. A tale scopo, è necessario abilitare la registrazione per Azure Data Manager for Agriculture. È quindi possibile salvare le informazioni di log in una destinazione, ad esempio un account di archiviazione, un hub eventi o un'area di lavoro Log Analytics, specificata.

Questo articolo illustra i passaggi per configurare la registrazione per Azure Data Manager for Agriculture.

Abilitare la raccolta di log

Dopo aver creato una risorsa del servizio Data Manager per l'agricoltura, passare alle impostazioni di diagnostica e quindi selezionare add diagnostics settings. Per iniziare a raccogliere e archiviare i log, seguire questa procedura:

1. Specificare un nome per l'impostazione di diagnostica.
2. Selezionare le categorie per cui si desidera iniziare a raccogliere i log.
3. Scegliere la destinazione per la raccolta dall'account di archiviazione, dall'hub eventi o da un'area di lavoro Log Analytics.

È ora possibile passare alla destinazione specificata nell'impostazione di diagnostica per accedere ai log. È possibile accedere alle informazioni di registrazione 10 minuti (al massimo) dopo l'operazione di Data Manager for Agriculture. Nella maggior parte dei casi, è più veloce.

Interpretare i log

Ogni log segue lo schema elencato nella tabella. La tabella contiene i nomi e le descrizioni dei campi:

Nome del campo	Descrizione
time	Data e ora in formato UTC.
resourceId	ID della risorsa di Azure Resource Manager. Per i log, si tratta dell'ID risorsa Data Manager for Agriculture.
operationName	Nome dell'operazione, come documentato.
operationVersion	Versione dell'API REST richiesta dal client.
category	Tipo di risultato.
resultType	Risultato della richiesta dell'API REST (esito positivo o negativo).
resultSignature	Stato HTTP.
resultDescription	Descrizione aggiuntiva del risultato, se disponibile.
durationMs	Tempo impiegato per soddisfare la richiesta API REST, in millisecondi.
callerIpAddress	Indirizzo IP del client che ha eseguito la richiesta.
level	Livello di gravità dell'evento (informativo, avviso, errore o critico).
correlationId	GUID facoltativo che può essere usato per correlare i log.
identity	Identità del token presentato nella richiesta API REST. Si tratta in genere di un ID oggetto e di un ID applicazione o di uno dei due.
location	Area della risorsa che genera l'evento, ad esempio "Stati Uniti orientali"
properties	Per ognuno di essi operationName contiene: requestUri (URI della richiesta API), partyId(partyId associato alla richiesta, ove applicabile),dataPlaneResourceId (ID che identifica in modo univoco la risorsa del piano dati nella richiesta) e requestBody (contiene il corpo della richiesta per la chiamata API associata a operationName per tutte le categorie diverse da ApplicationAuditLogs). Oltre al comune menzionato prima jobProcessesLogs della categoria ha: 1. Questo elenco è di campi in operationNames: jobRunType (può essere oneTime o periodico), jobId (ID del processo), initiatedBy (indica se un processo è stato attivato da un utente o dal servizio). 2. Questo elenco è di campi per i processi correlati a farmOperation non riusciti: farmOperationEntityId (ID dell'entità che non è stato possibile creare dal processo farmOperation), farmOperationEntityType(tipo dell'entità che non è stato possibile creare), errorCode(codice per errore del processo), errorMessage(descrizione dell'errore), internalErrorCode(codice di errore fornito dal provider), internalErrorMessage(descrizione dell'errore fornito dal provider), providerId(ID del provider).

Il categories campo data manager per l'agricoltura può avere valori elencati nella tabella seguente:

Tabella Categorie

Categoria	Descrizione
FarmManagementLogs	Log per operazioni CRUD per party, Farm, Field, Seasonal Field, CropVariety, Season, Attachment, prescription maps, prescrizioni, zone di gestione, zone, analisi dei tessuti vegetali e analisi nutrienti.
FarmOperationsLogs	Log per operazioni CRUD per il processo di inserimento dati FarmOperations, ApplicationData, PlantingData, HarvestingData, TillageData
SatelliteLogs	Log per creare e ottenere operazioni per il processo di inserimento dati satellite
WeatherLogs	Log per operazioni di creazione, eliminazione e recupero per il processo di inserimento dati meteo
ProviderAuthLogs	Log per creare, aggiornare, eliminare, eliminare a catena, ottenere e ottenere tutti per i provider Oauth. Include anche i log per ottenere, ottenere tutto, eliminare a catena per i token oauth.
JobProcessedLogs	Log per indicare l'esito positivo o negativo e il motivo dell'errore per i processi. Oltre ai log per i processi di eliminazione a catena delle risorse, i processi di inserimento dati contengono anche i log per le operazioni della farm e i processi di gestione degli eventi.
ModelInferenceLogs	Log per creare e ottenere operazioni per il processo del modello di biomassa.
InsightLogs	Log per ottenere e ottenere tutte le operazioni per informazioni dettagliate.
ApplicationAuditLogs	Log per azioni con privilegi, ad esempio le operazioni di creazione, aggiornamento, eliminazione e gestione delle sottoscrizioni del piano dati. L'elenco completo è riportato nella tabella dei nomi dell'operazione seguente.

I valori dei operationName campi sono in formato Microsoft.AgFoodPlatform/resource-name/read o write o delete o action .

• /write suffisso nel nome dell'operazione corrisponde a una creazione o aggiornamento del nome della risorsa
• /readsuffisso nel nome dell'operazione corrisponde a una chiamata API GET/ LIST /GET ALL o allo stato GET per un processo di eliminazione a catena per il nome della risorsa
• /delete suffisso corrisponde all'eliminazione di resource-name
• /action suffisso corrisponde alle chiamate al metodo POST per un nome di risorsa
• /processed suffisso corrisponde al completamento di un processo (una chiamata al metodo PUT). Indica lo stato del processo (esito positivo o negativo).
• /failures il suffisso corrisponde all'errore di un processo dell'operazione farm (chiamata al metodo PUT) e contiene una descrizione relativa al motivo dell'errore.

La denominazione dei posti di lavoro è la seguente:

• Per i processi di inserimento dati: Microsoft.AgFoodPlatform/ingestionJobs/<'resource-name'DataingestionJobs>/write
• Per i processi di eliminazione: Microsoft.AgFoodPlatform/deletionJobs/<'resource-name'cascadeDeleteJobs>/write

La tabella seguente elenca i valori operationName e i comandi DELL'API REST corrispondenti per una categoria come scheda:

FarmManagementLogs

operationName
Microsoft.AgFoodPlatform/farmers/write
Microsoft.AgFoodPlatform/farmers/read
Microsoft.AgFoodPlatform/deletionJobs/farmersCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/farms/write
Microsoft.AgFoodPlatform/farms/read
Microsoft.AgFoodPlatform/farms/delete
Microsoft.AgFoodPlatform/deletionJobs/farmsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/field/write
Microsoft.AgFoodPlatform/field/read
Microsoft.AgFoodPlatform/field/delete
Microsoft.AgFoodPlatform/deletionJobs/fieldsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/seasonalField/write
Microsoft.AgFoodPlatform/seasonalField/read
Microsoft.AgFoodPlatform/seasonalField/delete
Microsoft.AgFoodPlatform/deletionJobs/seasonalFieldsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/boundaries/write
Microsoft.AgFoodPlatform/boundaries/read
Microsoft.AgFoodPlatform/boundaries/delete
Microsoft.AgFoodPlatform/boundaries/action
Microsoft.AgFoodPlatform/deletionJobs/fieldsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/crop/write
Microsoft.AgFoodPlatform/crop/read
Microsoft.AgFoodPlatform/crop/delete
Microsoft.AgFoodPlatform/cropVarieties/write
Microsoft.AgFoodPlatform/cropVarieties/read
Microsoft.AgFoodPlatform/cropVarieties/delete
Microsoft.AgFoodPlatform/seasons/write
Microsoft.AgFoodPlatform/seasons/read
Microsoft.AgFoodPlatform/seasons/delete
Microsoft.AgFoodPlatform/attachments/write
Microsoft.AgFoodPlatform/attachments/read
Microsoft.AgFoodPlatform/attachments/delete
Microsoft.AgFoodPlatform/prescriptions/write
Microsoft.AgFoodPlatform/prescriptions/read
Microsoft.AgFoodPlatform/prescriptions/delete
Microsoft.AgFoodPlatform/deletionJobs/prescriptionsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/prescription Mappe/write
Microsoft.AgFoodPlatform/prescription Mappe/read
Microsoft.AgFoodPlatform/prescription Mappe/delete
Microsoft.AgFoodPlatform/deletionJobs/prescription Mappe CascadeDeleteJobs/write
Microsoft.AgFoodPlatform/managementZones/write
Microsoft.AgFoodPlatform/managementZones/read
Microsoft.AgFoodPlatform/managementZones/delete
Microsoft.AgFoodPlatform/deletionJobs/managementZonescascadeDeletejobs/write
Microsoft.AgFoodPlatform/zones/write
Microsoft.AgFoodPlatform/zones/read
Microsoft.AgFoodPlatform/zones/delete
Microsoft.AgFoodPlatform/deletionJobs/zonesCascadedeleteJobs/write
Microsoft.AgFoodPlatform/plantTissueanalyses/write
Microsoft.AgFoodPlatform/plantTissueanalyses/read
Microsoft.AgFoodPlatform/plantTissueanalyses/delete
Microsoft.AgFoodPlatform/deletionJobs/plantTissueanalysesCascadedeleteJobs/write
Microsoft.AgFoodPlatform/nutrientAnalyses/write
Microsoft.AgFoodPlatform/nutrientAnalyses/read
Microsoft.AgFoodPlatform/nutrientAnalyses/delete
Microsoft.AgFoodPlatform//deletionJobs/nutrientAnalysescascadeDeletejobs/delete

FarmOperationLogs

operationName
Microsoft.AgFoodPlatform/ingetsionJobs/farmOperationsdataIngestionjobs/write
Microsoft.AgFoodPlatform/applicationData/read
Microsoft.AgFoodPlatform/applicationData/write
Microsoft.AgFoodPlatform/applicationData/delete
Microsoft.AgFoodPlatform/deletionJobs/applicationDatacascadeDeletejob/write
Microsoft.AgFoodPlatform/plantingData/write
Microsoft.AgFoodPlatform/plantingData/read
Microsoft.AgFoodPlatform/plantingData/delete
Microsoft.AgFoodPlatform/deletionJobs/plantingDatacascadeDeletejob/write
Microsoft.AgFoodPlatform/harvestingData/write
Microsoft.AgFoodPlatform/harvestingData/read
Microsoft.AgFoodPlatform/harvestingData/delete
Microsoft.AgFoodPlatform/deletionJobs/harvestingDatacascadeDeletejob/write
Microsoft.AgFoodPlatform/tillageData/Write
Microsoft.AgFoodPlatform/tillageData/Read
Microsoft.AgFoodPlatform/tillageData/Delete
Microsoft.AgFoodPlatform/deletionJobs/tillageDatacascadeDeletejob/write

SatelliteLogs

operationName
Microsoft.AgFoodPlatform/ingestionJobs/satelliteDataingestionJob/write
Microsoft.AgFoodPlatform/scenes/read

WeatherLogs

operationName
Microsoft.AgFoodPlatform/ingestionJobs/weatherDataingestionJob/write
Microsoft.AgFoodPlatform/weather/read
Microsoft.AgFoodPlatform/deleteJobs/weatherDeletejob/delete

ProviderAuthLogs

operationName
Microsoft.AgFoodPlatform/oauthProviders/write
Microsoft.AgFoodPlatform/oauthProviders/read
Microsoft.AgFoodPlatform/oauthProviders/delete
Microsoft.AgFoodPlatform/oauthTokens/read
Microsoft.AgFoodPlatform/oauthTokens/delete

JobProcessesLogs

operationName
Microsoft.AgFoodPlatform/ingestionJobs/satelliteDataIngestionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/satelliteDataDeletionJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/weatherDataIngestionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/weatherDataDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/oauthProvidersCascadeDeleteJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/oauthTokensRemoveJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/biomassModelJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/ImageProcessingRasterizeJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationDataIngestionJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationDataIngestionJobs/processed/failures
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationPeriodicJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationPeriodicJobs/processed/failures
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationEventHandlingJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationEventHandlingJobs/processed/failures
Microsoft.AgFoodPlatform/deletionJobs/applicationDataCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/tillageDataCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/plantingDataCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/harvestDataCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/managementZonesCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/zonesCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/plantTissueAnalysesCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/prescriptionsCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/prescription Mappe CascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/insightsCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/farmersCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/farmsCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/fieldsCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/seasonalFieldsCascadeDeletionJobs/processed

ApplicationAuditLogs

Anche i log di scrittura ed eliminazione presenti in altre categorie sono presenti in questa categoria. La differenza tra i log in questa categoria e altre categorie per la stessa chiamata API è che ApplicationAuditLogs non registra il corpo della richiesta, mentre in altre categorie viene popolato il corpo della richiesta. Usare l'ID correlazione per correlare i log di due categorie diverse per ottenere altri dettagli. Di seguito sono elencate alcune delle operazioni del piano di controllo che non fanno parte delle altre categorie.

operationName
Creare una risorsa data manager per l'agricoltura
Aggiornare data manager per la risorsa agricoltura
Eliminare data manager per la risorsa agricoltura
Creare la sottoscrizione
Aggiornamento di sottoscrizioni
Autenticazione del piano dati

Eseguire query sui log delle risorse in un'area di lavoro Log Analytics

Tutti i categories log delle risorse vengono mappati come tabella in Log Analytics. Per accedere ai log per ogni categoria, è necessario creare un'impostazione di diagnostica per inviare dati a un'area di lavoro Log Analytics. In questa area di lavoro è possibile eseguire una query su una qualsiasi delle tabelle elencate per ottenere i log pertinenti.

Elenco di tabelle in Log Analytics e relativo mapping alle categorie nei log delle risorse

Nome tabella in Log Analytics	Categorie nei log delle risorse	Descrizione
AgriFoodFarmManagementLogs	FarmManagementLogs	Log per operazioni CRUD per party, Farm, Field, Seasonal Field, CropVariety, Season, Attachment, prescription maps, prescrizioni, zone di gestione, zone, analisi dei tessuti vegetali e analisi nutrienti.
AgriFoodFarmOperationsLogs	FarmOperationsLogs	Log per operazioni CRUD per il processo di inserimento dati FarmOperations, ApplicationData, PlantingData, HarvestingData, TillageData.
AgriFoodSatelliteLogs	SatelliteLogs	Log per creare e ottenere operazioni per il processo di inserimento dati satellite.
AgriFoodWeatherLogs	WeatherLogs	Log per operazioni di creazione, eliminazione e recupero per il processo di inserimento dati meteo.
AgriFoodProviderAuthLogs	ProviderAuthLogs	Log per creare, aggiornare, eliminare, eliminare a catena, ottenere e ottenere tutti per i provider oauth. Include anche i log per ottenere, ottenere tutto, eliminare a catena per i token oauth.
AgriFoodInsightLogs	InsightLogs	Log per ottenere e ottenere tutte le operazioni per informazioni dettagliate.
AgriFoodModelInferenceLogs	ModelInferenceLogs	Log per creare e ottenere operazioni per il processo del modello di biomassa.
AgriFoodJobProcessedLogs	JobProcessedLogs	Log per indicare l'esito positivo o negativo e il motivo dell'errore per i processi. Oltre ai log per i processi di eliminazione a catena delle risorse, i processi di inserimento dati. Contiene anche i log per le operazioni della farm e i processi di gestione degli eventi.
AgriFoodApplicationAuditLogs	ApplicationAuditLogs	Log per azioni con privilegi, ad esempio le operazioni di creazione, aggiornamento, eliminazione e gestione delle sottoscrizioni del piano dati.

Elenco di colonne nelle tabelle di Log Analytics

Nome del campo	Descrizione
Time	Data e ora in formato UTC.
ResourceId	ID risorsa di Azure Resource Manager per i log di Data Manager per l'agricoltura.
OperationName	Nome dell'operazione, come documentato nella tabella precedente.
OperationVersion	Versione dell'API REST richiesta dal client.
Categoria	I dettagli delle categorie nei log di Data Manager per l'agricoltura possono essere qualsiasi valore, come indicato nella tabella delle categorie.
Resulttype	Risultato della richiesta dell'API REST (esito positivo o negativo).
ResultSignature	Stato HTTP.
ResultDescription	Altre informazioni sul risultato, se disponibili.
DurationMs	Tempo impiegato per soddisfare la richiesta API REST, in millisecondi.
CallerIpAddress	Indirizzo IP del client che ha eseguito la richiesta.
Livello	Livello di gravità dell'evento (informativo, avviso, errore o critico).
CorrelationId	GUID facoltativo che può essere usato per correlare i log.
ApplicationId	ID applicazione che indica l'identità del chiamante.
ObjectId	ID oggetto che indica l'identità del chiamante.
ClientTenantId	ID del tenant del chiamante.
SubscriptionId	ID della sottoscrizione utilizzata dal chiamante.
Location	Area della risorsa che genera l'evento, ad esempio "Stati Uniti orientali"
JobRunType	Disponibile solo nella AgriFoodJobProcessesLogs tabella, indica il tipo di esecuzione del processo. Il valore può essere periodico o una sola volta.
Jobid	Disponibile inAgriFoodJobProcessesLogs, AgriFoodSatelliteLogs, AgriFoodWeatherLogse AgriFoodModelInferenceLogs, indica l'ID del processo.
InitiatedBy	Disponibile solo nella AgriFoodJobProcessesLogs tabella. Indica se un processo è stato avviato da un utente o dal servizio.
partyId	ID della parte associata all'operazione.
Proprietà	Disponibile solo nellaAgriFoodJobProcessesLogs tabella, contiene: farmOperationEntityId (ID dell'entità che non è riuscita a essere creata dal processo farmOperation), farmOperationEntityType(Tipo dell'entità che non è stato possibile creare, può essere ApplicationData, PeriodicJob e così via), errorCode(Codice per errore del processo in Data Manager per l'agricoltura),errorMessage(Descrizione dell'errore alla fine del data manager per l'agricoltura)internalErrorCode(Codice di errore del processo fornito dal provider) internalErrorMessage(Descrizione dell'errore fornito dal provider),providerId(ID del provider, ad esempio JOHN-D edizione Enterprise RE).

È possibile eseguire query su ognuna di queste tabelle creando un'area di lavoro Log Analytics. Informazioni di riferimento sul linguaggio di query sono disponibili qui.

Elenco di query di esempio nell'area di lavoro Log Analytics

Nome query	Descrizione
Stato delle operazioni di gestione farm per un'entità	Recupera un conteggio dei successi e degli errori delle operazioni all'interno della FarmManagementLogs categoria per ogni parte.
Statistiche di esecuzione del processo per un'entità	Fornisce un conteggio dei successi e degli errori di per tutte le operazioni nella JobProcessedLogs categoria per ogni parte.
Autorizzazione non riuscita	Identifica un elenco di utenti che non hanno eseguito l'accesso alla risorsa e il motivo di questo errore.
Stato di tutte le operazioni per un'entità	Aggrega errori e successi in tutte le categorie per un'entità.
Tendenze di utilizzo per le prime 100 parti in base alle operazioni eseguite	Recupera un elenco delle prime 100 parti in base al numero di riscontri ricevuti tra le categorie. Questa query può essere modificata per tenere traccia della tendenza di utilizzo per una determinata parte.

Tutte le query elencate in precedenza possono essere usate come query di base per formare query personalizzate in un'area di lavoro Log Analytics. È anche possibile accedere a questo elenco di query nella scheda della Logs risorsa Azure Data Manager for Agriculture in portale di Azure.

Passaggi successivi

Informazioni su come configurare i collegamenti privati.