Azure Data Manager for Agriculture-loggning
När du har skapat en resursinstans för Data Manager for Agriculture kan du övervaka hur och när dina resurser används och av vem. Du kan också felsöka orsaker till fel för dataplansbegäranden. För att göra detta måste du aktivera loggning för Azure Data Manager for Agriculture. Du kan sedan spara logginformation på ett mål, till exempel ett lagringskonto, en händelsehubb eller en log analytics-arbetsyta som du anger.
Den här artikeln innehåller stegen för att konfigurera loggning för Azure Data Manager for Agriculture.
Aktivera insamling av loggar
När du har skapat en Data Manager for Agriculture-tjänstresurs navigerar du till diagnostikinställningarna och väljer add diagnostics settingssedan . Följ dessa steg för att börja samla in och lagra loggar:
- Tillhandahåll ett namn för diagnostikinställningen.
- Välj de kategorier som du vill börja samla in loggar för.
- Välj mål för insamling från lagringskonto, händelsehubb eller en log analytics-arbetsyta.
Nu kan du navigera till det mål som du angav i diagnostikinställningen för att komma åt loggar. Du kan komma åt loggningsinformationen 10 minuter (högst) efter åtgärden Data Manager för jordbruk. I de flesta fall går det snabbare.
Tolka loggarna
Varje logg följer schemat som anges i tabellen. Tabellen innehåller fältnamn och beskrivningar:
| Fältnamn | beskrivning |
|---|---|
| Tid | Datum och tid i UTC. |
| resourceId | Resurs-ID för Azure Resource Manager. För loggar är detta resurs-ID för Data Manager for Agriculture. |
| operationName | Namnet på åtgärden enligt beskrivningen. |
| operationVersion | REST API-version som begärs av klienten. |
| kategori | Typ av resultat. |
| resultType | Resultatet av REST API-begäran (lyckad eller misslyckad). |
| resultSignature | HTTP-status. |
| resultDescription | Extra beskrivning av resultatet när det är tillgängligt. |
| durationMs | Hur lång tid i millisekunder som det tog att utföra REST-API-begäran. |
| callerIpAddress | IP-adressen för klienten som gjorde begäran. |
| nivå | Allvarlighetsgraden för händelsen (information, varning, fel eller kritisk). |
| correlationId | Ett valfritt GUID som kan användas för att korrelera loggar. |
| identitet | Identitet från token som visades i REST API-begäran. Det här är vanligtvis ett objekt-ID och ett program-ID eller något av de två. |
| Plats | Regionen för resursen som genererar händelsen, till exempel "USA, östra" |
| Egenskaper | För varje operationName detta innehåller: requestUri (URI för API-begäran), partyId(partyId som är associerat med begäran, i förekommande fall),dataPlaneResourceId (ID som unikt identifierar dataplansresursen i begäran) och requestBody (innehåller begärandetexten för API-anropet som är associerat med operationName för alla kategorier förutom ApplicationAuditLogs). Förutom den gemensamma som nämns före jobProcessesLogs kategorin har: 1. Den här listan innehåller fält mellan operationNames: jobRunType (kan vara oneTime eller periodisk), jobId (ID för jobbet) initiatedBy (anger om ett jobb utlöstes av en användare eller av tjänsten). 2. Den här listan innehåller fält för misslyckade farmOperation-relaterade jobb: farmOperationEntityId (ID för entiteten som inte kunde skapas av farmOperation-jobbet), farmOperationEntityType(typ av entitet som inte kunde skapas), errorCode(kod för jobbfel), errorMessage(beskrivning av felkod internalErrorCodesom tillhandahålls av providern), internalErrorMessage(beskrivning av det fel som tillhandahålls av providern), providerId(ID för providern). |
Fältet categories för Data Manager för jordbruk kan ha värden som visas i följande tabell:
Kategoritabell
| category | beskrivning |
|---|---|
| FarmManagementLogs | Loggar för CRUD-åtgärder för party, Farm, Field, Seasonal Field, Crop, CropVariety, Season, Attachment, prescription maps, prescriptions, management zones, zones, plant tissue analysis and nutrient analysis. |
| FarmOperationsLogs | Loggar för CRUD-åtgärder för Inmatningsjobb för FarmOperations-data, ApplicationData, PlantingData, HarvestingData, TillageData |
| Satellitloggar | Loggar för att skapa och hämta åtgärder för datainmatningsjobb för satellit |
| WeatherLogs | Loggar för att skapa, ta bort och hämta åtgärder för datainmatningsjobb för väder |
| ProviderAuthLogs | Loggar för att skapa, uppdatera, ta bort, ta bort, hämta och hämta alla för OAuth-leverantörer. Den har också loggar för att hämta, hämta alla, kaskadborttagning för oauth-token. |
| JobProcessedLogs | Loggar för att ange lyckade eller misslyckade och orsaken till fel för jobb. Förutom loggar för borttagningsjobb för resurskaskad, datainmatningsjobb, innehåller den även loggar för servergruppsåtgärder och händelsehanteringsjobb. |
| ModelInferenceLogs | Loggar för att skapa och hämta åtgärder för modelljobb för biomassa. |
| InsightLogs | Loggar för att hämta och hämta alla åtgärder för insikter. |
| ApplicationAuditLogs | Loggar för privilegierade åtgärder som att skapa, uppdatera, ta bort och hantera prenumerationer på dataplansresurser. Fullständig lista finns i tabellen för åtgärdsnamn nedan. |
Fältvärdena operationName finns i Microsoft.AgFoodPlatform/resource-name/read eller write eller delete eller action format.
/writesuffixet i åtgärdsnamnet motsvarar en skapa eller uppdatera resursnamnet/readsuffixet i åtgärdsnamnet motsvarar ett GET/LIST/GET ALL API-anrop eller GET-status för ett kaskadborttagningsjobb för resursnamnet/deletesuffix motsvarar borttagningen av resursnamnet/actionsuffix motsvarar POST-metodanrop för ett resursnamn/processedsuffix motsvarar slutförandet av ett jobb (ett PUT-metodanrop). Detta anger status för jobbet (lyckades eller misslyckades)./failuressuffixet motsvarar felet för ett servergruppsåtgärdsjobb (ett PUT-metodanrop) och innehåller en beskrivning av orsaken till felet.
Nomenklaturen för jobb är följande:
- För datainmatningsjobb: Microsoft.AgFoodPlatform/ingestionJobs/<'resource-name'DataingestionJobs>/write
- För borttagningsjobb: Microsoft.AgFoodPlatform/deletionJobs/<'resource-name'cascadeDeleteJobs>/write
I följande tabell visas värdena för operationName och motsvarande REST API-kommandon för en kategori som en flik:
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/gränser/skrivning |
| Microsoft.AgFoodPlatform/gränser/läs |
| Microsoft.AgFoodPlatform/gränser/ta bort |
| Microsoft.AgFoodPlatform/gränser/åtgärd |
| Microsoft.AgFoodPlatform/deletionJobs/fieldsCascadeDeleteJobs/write |
| Microsoft.AgFoodPlatform/crops/write |
| Microsoft.AgFoodPlatform/crops/read |
| Microsoft.AgFoodPlatform/crops/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/recept/skrivning |
| Microsoft.AgFoodPlatform/recept/läs |
| Microsoft.AgFoodPlatform/recept/ta bort |
| Microsoft.AgFoodPlatform/deletionJobs/prescriptionsCascadeDeleteJobs/write |
| Microsoft.AgFoodPlatform/prescriptionMaps/write |
| Microsoft.AgFoodPlatform/prescriptionMaps/read |
| Microsoft.AgFoodPlatform/prescriptionMaps/delete |
| Microsoft.AgFoodPlatform/deletionJobs/prescriptionMapsCascadeDeleteJobs/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 |
Satellitloggar
| operationName |
|---|
| Microsoft.AgFoodPlatform/ingestionJobs/satelliteDataingestionJob/write |
| Microsoft.AgFoodPlatform/scenes/read |
WeatherLogs
| operationName |
|---|
| Microsoft.AgFoodPlatform/ingestionJobs/weatherDataingestionJob/write |
| Microsoft.AgFoodPlatform/weather/read |
| Microsoft.AgFoodPlatform/deletionJobs/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/prescriptionMapsCascadeDeletionJobs/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
Skriv- och borttagningsloggarna som finns i andra kategorier finns också i den här kategorin. Skillnaden mellan loggarna i den här kategorin och andra kategorier för samma API-anrop är att ApplicationAuditLogs inte loggar begärandetexten, medan begäran-brödtexten i andra kategorier är ifylld. Använd korrelations-ID för att relatera loggar för två olika kategorier för att få mer information. Några av de kontrollplansåtgärder som inte ingår i resten av kategorierna visas nedan.
Kommentar
För att göra kontrollplansanrop behöver du ägaråtkomst till ADMA-resursomfånget.
| operationName |
|---|
| Skapa Data Manager för jordbruksresurs |
| Uppdatera Data Manager för jordbruksresurs |
| Ta bort Data Manager för jordbruksresurs |
| Skapa en prenumeration |
| Uppdatera prenumeration |
| Autentisering med dataplan |
Fråga efter resursloggar på en log analytics-arbetsyta
categories Alla resursloggar mappas som en tabell i Log Analytics. För att få åtkomst till loggar för varje kategori måste du skapa en diagnostikinställning för att skicka data till en log analytics-arbetsyta. På den här arbetsytan kan du fråga någon av tabellerna i listan för att hämta relevanta loggar.
Lista över tabeller i logganalys och deras mappning till kategorier i resursloggar
| Tabellnamn i log analytics | Kategorier i resursloggar | beskrivning |
|---|---|---|
| AgriFoodFarmManagementLogs | FarmManagementLogs | Loggar för CRUD-åtgärder för party, Farm, Field, Seasonal Field, Crop, CropVariety, Season, Attachment, prescription maps, prescriptions, management zones, zones, plant tissue analysis and nutrient analysis. |
| AgriFoodFarmOperationsLogs | FarmOperationsLogs | Loggar för CRUD-åtgärder för Inmatningsjobb för FarmOperations-data, ApplicationData, PlantingData, HarvestingData och TillageData. |
| AgriFoodSatelliteLogs | Satellitloggar | Loggar för att skapa och hämta åtgärder för satellitdatainmatningsjobb. |
| AgriFoodWeatherLogs | WeatherLogs | Loggar för att skapa, ta bort och hämta åtgärder för datainmatningsjobb för väder. |
| AgriFoodProviderAuthLogs | ProviderAuthLogs | Loggar för att skapa, uppdatera, ta bort, ta bort, hämta och hämta alla för oauth-leverantörer. Den har också loggar för att hämta, hämta alla, kaskadborttagning för oauth-token. |
| AgriFoodInsightLogs | InsightLogs | Loggar för att hämta och hämta alla åtgärder för insikter. |
| AgriFoodModelInferenceLogs | ModelInferenceLogs | Loggar för att skapa och hämta åtgärder för modelljobb för biomassa. |
| AgriFoodJobProcessedLogs | JobProcessedLogs | Loggar för att ange lyckade eller misslyckade och orsaken till fel för jobb. Förutom loggar för borttagningsjobb för resurskaskad, datainmatningsjobb. Den innehåller också loggar för servergruppsåtgärder och händelsehanteringsjobb. |
| AgriFoodApplicationAuditLogs | ApplicationAuditLogs | Loggar för privilegierade åtgärder som att skapa, uppdatera, ta bort och hantera prenumerationer på dataplansresurser. |
Lista över kolumner i log analytics-tabeller
| Fältnamn | beskrivning |
|---|---|
| Tid | Datum och tid i UTC. |
| ResourceId | Azure Resource Manager-resurs-ID för Data Manager for Agriculture-loggar. |
| OperationName | Namnet på åtgärden, enligt beskrivningen i den tidigare tabellen. |
| OperationVersion | REST API-version som begärs av klienten. |
| Kategori | Kategoriinformation i Data Manager for Agriculture-loggarna kan vara valfritt värde enligt listan i kategoritabellen. |
| ResultType | Resultatet av REST API-begäran (lyckad eller misslyckad). |
| ResultSignature | HTTP-status. |
| ResultDescription | Mer beskrivning av resultatet, när det är tillgängligt. |
| Varaktigheter | Hur lång tid i millisekunder som det tog att utföra REST-API-begäran. |
| CallerIpAddress | IP-adressen för klienten som gjorde begäran. |
| Nivå | Allvarlighetsgraden för händelsen (information, varning, fel eller kritisk). |
| CorrelationId | Ett valfritt GUID som kan användas för att korrelera loggar. |
| ApplicationId | Program-ID som anger anroparens identitet. |
| ObjectId | Objekt-ID som anger anroparens identitet. |
| ClientTenantId | ID för anroparens klientorganisation. |
| SubscriptionId | ID för prenumerationen som används av anroparen. |
| Plats | Regionen för resursen som genererar händelsen, till exempel "USA, östra" |
| JobRunType | Tillgänglig endast i AgriFoodJobProcessesLogs tabellen, anger typ av jobbkörning. Värdet kan vara antingen periodiskt eller en gång. |
| JobId | Tillgängligt iAgriFoodJobProcessesLogs, AgriFoodSatelliteLogs, AgriFoodWeatherLogsoch AgriFoodModelInferenceLogs, anger ID för jobbet. |
| InitiatedBy | Endast tillgängligt i AgriFoodJobProcessesLogs tabellen. Anger om ett jobb initierades av en användare eller av tjänsten. |
| partyId | ID för den part som är associerad med åtgärden. |
| Egenskaper | Den är endast tillgänglig iAgriFoodJobProcessesLogs tabellen och innehåller: farmOperationEntityId (ID för den entitet som inte kunde skapas av farmOperation-jobbet), farmOperationEntityType(typ av entitet som inte kunde skapas, kan vara ApplicationData, PeriodicJob osv.), errorCode(Kod för fel i jobbet vid Data Manager för jordbruk-slut),errorMessage(Beskrivning av fel vid datahanteraren för jordbrukets slut),internalErrorCode(Kod för fel i jobbet som tillhandahålls av providern), internalErrorMessage(Beskrivning av det fel som tillhandahålls av leverantören),providerId(ID för leverantören, till exempel JOHN-DEERE). |
Var och en av dessa tabeller kan efterfrågas genom att skapa en log analytics-arbetsyta. Referens för frågespråket finns här.
Lista över exempelfrågor på log analytics-arbetsytan
| Frågenamn | beskrivning |
|---|---|
| Status för servergruppshanteringsåtgärder för en part | Hämtar antalet lyckade och misslyckade åtgärder inom FarmManagementLogs kategorin för varje part. |
| Jobbkörningsstatistik för en part | Innehåller ett antal lyckade och misslyckade åtgärder för alla åtgärder i JobProcessedLogs kategorin för varje part. |
| Misslyckad auktorisering | Identifierar en lista över användare som inte kunde komma åt resursen och orsaken till felet. |
| Status för alla åtgärder för en part | Aggregerar fel och lyckade resultat mellan kategorier för en part. |
| Användningstrender för de 100 främsta parterna baserat på de åtgärder som utförs | Hämtar en lista över de 100 främsta parterna baserat på antalet mottagna träffar i olika kategorier. Den här frågan kan redigeras för att spåra användningstrenden för en viss part. |
Alla frågor som anges ovan kan användas som basfrågor för att skapa anpassade frågor på en log analytics-arbetsyta. Den här listan med frågor kan också nås på fliken Logs i din Azure Data Manager for Agriculture-resurs på Azure Portal.
Nästa steg
Lär dig hur du konfigurerar privata länkar.