Logboekregistratie van Azure Data Manager for Agriculture
Nadat u een Data Manager for Agriculture-resource-exemplaar hebt gemaakt, kunt u controleren hoe en wanneer uw resources worden geopend en door wie. U kunt ook foutopsporingsredenen opsporen voor fouten voor gegevensvlakaanvragen. Hiervoor moet u logboekregistratie inschakelen voor Azure Data Manager for Agriculture. Vervolgens kunt u logboekgegevens opslaan op een bestemming, zoals een opslagaccount, Event Hub of een Log Analytics-werkruimte die u opgeeft.
Dit artikel bevat de stappen voor het instellen van logboekregistratie voor Azure Data Manager for Agriculture.
Verzameling logboeken inschakelen
Nadat u een Data Manager for Agriculture-serviceresource hebt gemaakt, gaat u naar diagnostische instellingen en selecteert u add diagnostics settings. Volg deze stappen om logboeken te verzamelen en op te slaan:
- Voer een naam in voor de diagnostische instelling.
- Selecteer de categorieën waarvoor u logboeken wilt verzamelen.
- Kies het doel voor verzameling uit een opslagaccount, Event Hub of een Log Analytics-werkruimte.
U kunt nu naar de bestemming gaan die u hebt opgegeven in de diagnostische instelling voor toegang tot logboeken. U hebt 10 minuten (maximaal) toegang tot uw logboekgegevens na de data manager voor de landbouwbewerking. In de meeste gevallen is het sneller.
Uw logboeken interpreteren
Elk logboek volgt het schema dat in de tabel wordt vermeld. De tabel bevat de veldnamen en beschrijvingen:
| Veldnaam | Beschrijving |
|---|---|
| time | Datum en tijd in UTC. |
| resourceId | Azure Resource Manager-resource-id. Voor logboeken is dit de Data Manager for Agriculture-resource-id. |
| operationName | Naam van de bewerking, zoals gedocumenteerd. |
| operationVersion | REST-API-versie die door de client is aangevraagd. |
| category | Type resultaat. |
| resultType | Resultaat van de REST API-aanvraag (geslaagd of mislukt). |
| resultSignature | HTTP-status. |
| resultDescription | Extra beschrijving over het resultaat, indien beschikbaar. |
| durationMs | De tijd die nodig was om de REST-API-aanvraag af te handelen in milliseconden. |
| callerIpAddress | IP-adres van de client die de aanvraag heeft ingediend. |
| niveau | Het ernstniveau van de gebeurtenis (informatie, waarschuwing, fout of kritiek). |
| correlationId | Een optionele GUID die kan worden gebruikt om logboeken te correleren. |
| identity | De identiteit van het token dat is opgegeven in de REST-API-aanvraag. Dit is meestal een object-id en een toepassings-id of een van de twee. |
| location | De regio van de resource die de gebeurtenis verzendt, zoals 'VS - oost' |
| properties | Voor elk operationName hiervan bevat: requestUri (URI van de API-aanvraag), partyId(partyId die is gekoppeld aan de aanvraag, indien van toepassing),dataPlaneResourceId (id die de gegevensvlakresource in de aanvraag uniek identificeert) en requestBody (bevat de aanvraagbody voor de API-aanroep die is gekoppeld aan de operationName voor alle categorieën anders dan ApplicationAuditLogs). Behalve de gangbare die wordt vermeld voordat jobProcessesLogs de categorie: 1 heeft. Deze lijst bevat velden tussen operationNames: jobRunType (kan oneTime of periodiek zijn), jobId (id van de taak) initiatedBy (geeft aan of een taak is geactiveerd door een gebruiker of door de service). 2. Deze lijst bevat velden voor mislukte farmOperation-gerelateerde taken: farmOperationEntityId (id van de entiteit die niet kan worden gemaakt door de farmOperation-taak), farmOperationEntityType(type van de entiteit die niet is gemaakt), errorCode(code voor taakfout), errorMessage(beschrijving van de fout), internalErrorCode(foutcode opgeven door de provider), internalErrorMessage(beschrijving van de fout die door de provider is opgegeven), providerId(id van de provider). |
Het categories veld voor Data Manager for Agriculture kan waarden bevatten die worden vermeld in de volgende tabel:
Tabel Categorieën
| category | Beschrijving |
|---|---|
| FarmManagementLogs | Logboeken voor CRUD-bewerkingen voor party-, farm-, veld-, seizoensveld, gewas, gewas, seizoen, bijlage, receptkaarten, recepten, beheerzones, zones, plantenweefselanalyse en voedingsanalyses. |
| FarmOperationsLogs | Logboeken voor CRUD-bewerkingen voor FarmOperations-gegevensopnametaak, ApplicationData, PlantingData, HarvestingData, TillageData |
| SatelliteLogs | Logboeken voor het maken en ophalen van bewerkingen voor satellietgegevensopnametaak |
| WeatherLogs | Logboeken voor het maken, verwijderen en ophalen van bewerkingen voor opnametaak voor weergegevens |
| ProviderAuthLogs | Logboeken voor het maken, bijwerken, verwijderen, trapsgewijs verwijderen, ophalen en ophalen van alles voor OAuth-providers. Het bevat ook logboeken voor ophalen, alles ophalen, trapsgewijs verwijderen voor oauth-tokens. |
| JobProcessedLogs | Logboeken voor het aangeven van geslaagde of mislukte taken en de reden van de fout voor taken. Naast logboeken voor taken voor trapsgewijs verwijderen van resources, gegevensopnametaken, bevat het ook logboeken voor farmbewerkingen en gebeurtenisafhandelingstaken. |
| ModelInferenceLogs | Logboeken voor het maken en ophalen van bewerkingen voor biomassamodeltaak. |
| InsightLogs | Logboeken voor het ophalen en ophalen van alle bewerkingen voor inzichten. |
| ApplicationAuditLogs | Logboeken voor bevoegde acties, zoals bewerkingen voor het maken, bijwerken, verwijderen en beheren van abonnementen, zoals het maken, bijwerken, verwijderen en beheren van abonnementen. De volledige lijst staat in de onderstaande tabel met bewerkingsnamen. |
De operationName veldwaarden bevinden zich in Microsoft.AgFoodPlatform/resource-name/read- of write- of delete- of actie-indeling .
/writeachtervoegsel in de naam van de bewerking komt overeen met een resourcenaam maken of bijwerken/readachtervoegsel in de naam van de bewerking komt overeen met een GET/LIST /GET ALL API-aanroepen of GET-status voor een trapsgewijs verwijderen taak voor de resourcenaam/deleteachtervoegsel komt overeen met het verwijderen van de resourcenaam/actionachtervoegsel komt overeen met POST-methode-aanroepen voor een resourcenaam/processedachtervoegsel komt overeen met het voltooien van een taak (een PUT-methode-aanroep). Hiermee wordt de status van de taak (geslaagd of mislukt) aangegeven./failuresAchtervoegsel komt overeen met het mislukken van een farmbewerkingstaak (een PUT-methode-aanroep) en bevat een beschrijving van de reden van de fout.
De nomenclatuur voor taken is als volgt:
- Voor gegevensopnametaken: Microsoft.AgFoodPlatform/ingestionJobs/<'resource-name'DataingestionJobs>/write
- Voor verwijderingstaken: Microsoft.AgFoodPlatform/deletionJobs/<'resource-name'cascadeDeleteJobs>/write
De volgende tabel bevat de operationName-waarden en bijbehorende REST API-opdrachten voor een categorie als tabblad:
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/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/voorschriften/schrijven |
| Microsoft.AgFoodPlatform/voorschriften/lezen |
| Microsoft.AgFoodPlatform/voorschriften/verwijderen |
| 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 |
SatelliteLogs
| operationName |
|---|
| Microsoft.AgFoodPlatform/ingestionJobs/satelliteDataingestionJob/write |
| Microsoft.AgFoodPlatform/scènes/lezen |
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/biomassaModelJobs/verwerkt |
| 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
De schrijf- en verwijderlogboeken in andere categorieën zijn ook aanwezig in deze categorie. Het verschil tussen de logboeken in deze categorie en andere categorieën voor dezelfde API-aanroep is dat ApplicationAuditLogs de aanvraagbody niet registreert, terwijl in andere categorieën de aanvraagbody wordt ingevuld. Gebruik de correlatie-id om logboeken van twee verschillende categorieën te relateren voor meer informatie. Hieronder vindt u enkele besturingsvlakbewerkingen die geen deel uitmaken van de rest van de categorieën.
Notitie
Als u besturingsvlak-aanroepen wilt maken, hebt u eigenaarstoegang nodig voor het ADMA-resourcebereik.
| operationName |
|---|
| Data Manager maken voor landbouwresource |
| Data Manager voor landbouwresource bijwerken |
| Data Manager voor landbouwresource verwijderen |
| Abonnement maken |
| Abonnement bijwerken |
| Verificatie van gegevensvlak |
Resourcelogboeken opvragen in een Log Analytics-werkruimte
categories Alle resourcelogboeken worden toegewezen als een tabel in Log Analytics. Voor toegang tot logboeken voor elke categorie moet u een diagnostische instelling maken om gegevens naar een Log Analytics-werkruimte te verzenden. In deze werkruimte kunt u een query uitvoeren op alle tabellen die worden weergegeven om de relevante logboeken te verkrijgen.
Lijst met tabellen in Log Analytics en de toewijzing ervan aan categorieën in resourcelogboeken
| Tabelnaam in Log Analytics | Categorieën in resourcelogboeken | Beschrijving |
|---|---|---|
| AgriFoodFarmManagementLogs | FarmManagementLogs | Logboeken voor CRUD-bewerkingen voor party-, farm-, veld-, seizoensveld, gewas, gewas, seizoen, bijlage, receptkaarten, recepten, beheerzones, zones, plantenweefselanalyse en voedingsanalyses. |
| AgriFoodFarmOperationsLogs | FarmOperationsLogs | Logboeken voor CRUD-bewerkingen voor FarmOperations-gegevensopnametaak, ApplicationData, PlantingData, HarvestingData, TillageData. |
| AgriFoodSatelliteLogs | SatelliteLogs | Logboeken voor het maken en ophalen van bewerkingen voor satellietgegevensopnametaak. |
| AgriFoodWeatherLogs | WeatherLogs | Logboeken voor het maken, verwijderen en ophalen van bewerkingen voor opnametaak voor weergegevens. |
| AgriFoodProviderAuthLogs | ProviderAuthLogs | Logboeken voor het maken, bijwerken, verwijderen, trapsgewijs verwijderen, ophalen en ophalen voor oauth-providers. Het bevat ook logboeken voor ophalen, alles ophalen, trapsgewijs verwijderen voor oauth-tokens. |
| AgriFoodInsightLogs | InsightLogs | Logboeken voor het ophalen en ophalen van alle bewerkingen voor inzichten. |
| AgriFoodModelInferenceLogs | ModelInferenceLogs | Logboeken voor het maken en ophalen van bewerkingen voor biomassamodeltaak. |
| AgriFoodJobProcessedLogs | JobProcessedLogs | Logboeken voor het aangeven van geslaagde of mislukte taken en de reden van de fout voor taken. Naast logboeken voor taken voor trapsgewijs verwijderen van resources, gegevensopnametaken. Het bevat ook logboeken voor farmbewerkingen en gebeurtenisafhandelingstaken. |
| AgriFoodApplicationAuditLogs | ApplicationAuditLogs | Logboeken voor bevoegde acties, zoals bewerkingen voor het maken, bijwerken, verwijderen en beheren van abonnementen, zoals het maken, bijwerken, verwijderen en beheren van abonnementen. |
Lijst met kolommen in Log Analytics-tabellen
| Veldnaam | Beschrijving |
|---|---|
| Tijd | Datum en tijd in UTC. |
| ResourceId | Resource-id van Azure Resource Manager voor Data Manager for Agriculture-logboeken. |
| OperationName | Naam van de bewerking, zoals beschreven in de eerdere tabel. |
| OperationVersion | REST-API-versie die door de client is aangevraagd. |
| Categorie | Categoriedetails in de Data Manager for Agriculture-logboeken, dit kan elke waarde zijn zoals vermeld in de categorietabel. |
| ResultType | Resultaat van de REST API-aanvraag (geslaagd of mislukt). |
| ResultSignature | HTTP-status. |
| ResultDescription | Meer beschrijving over het resultaat, indien beschikbaar. |
| DurationMs | De tijd die nodig was om de REST-API-aanvraag af te handelen in milliseconden. |
| CallerIpAddress | IP-adres van de client die de aanvraag heeft ingediend. |
| Niveau | Het ernstniveau van de gebeurtenis (informatieve, waarschuwing, fout of kritiek). |
| CorrelationId | Een optionele GUID die kan worden gebruikt om logboeken te correleren. |
| ApplicationId | Toepassings-id die de identiteit van de beller aangeeft. |
| ObjectId | Object-id die de identiteit van de aanroeper aangeeft. |
| ClientTenantId | Id van de tenant van de aanroeper. |
| SubscriptionId | Id van het abonnement dat door de beller wordt gebruikt. |
| Location | De regio van de resource die de gebeurtenis verzendt, zoals 'VS - oost' |
| JobRunType | Alleen beschikbaar in AgriFoodJobProcessesLogs tabel, geeft het type taakuitvoering aan. De waarde kan periodiek of eenmalig zijn. |
| JobId | Beschikbaar inAgriFoodJobProcessesLogs, AgriFoodSatelliteLogsAgriFoodWeatherLogs, en AgriFoodModelInferenceLogs, geeft de id van de taak aan. |
| InitiatedBy | Alleen beschikbaar in AgriFoodJobProcessesLogs tabel. Hiermee wordt aangegeven of een taak is gestart door een gebruiker of door de service. |
| partyId | Id van de partij die aan de bewerking is gekoppeld. |
| Eigenschappen | Alleen beschikbaar inAgriFoodJobProcessesLogs de tabel, bevat het: farmOperationEntityId (id van de entiteit die niet kan worden gemaakt door de farmOperation-taak), farmOperationEntityType(Type van de entiteit die niet kan worden gemaakt, kan ApplicationData, PeriodicJob, enzovoort) errorCodezijn (Code voor fout van de taak bij Data Manager voor landbouw),errorMessage(Beschrijving van de fout bij het einde van de Data Manager voor Landbouw),internalErrorCode(Code of failure of the job provide by the provider), internalErrorMessage(Beschrijving van de fout van de provider),providerId(id van de provider, zoals JOHN-DEERE). |
Elk van deze tabellen kan worden opgevraagd door een Log Analytics-werkruimte te maken. Referentie voor querytaal is hier.
Lijst met voorbeeldquery's in de Log Analytics-werkruimte
| Querynaam | Beschrijving |
|---|---|
| Status van farmbeheerbewerkingen voor een partij | Haalt een telling van geslaagde en mislukte bewerkingen op binnen de FarmManagementLogs categorie voor elke partij. |
| Statistieken voor taakuitvoering voor een partij | Biedt een telling van successen en mislukkingen voor alle bewerkingen in de JobProcessedLogs categorie voor elke partij. |
| Mislukte autorisatie | Identificeert een lijst met gebruikers die geen toegang hebben tot uw resource en de reden voor deze fout. |
| Status van alle bewerkingen voor een partij | Hiermee worden fouten en successen samengevoegd in verschillende categorieën voor een partij. |
| Gebruikstrends voor top 100 partijen op basis van de uitgevoerde bewerkingen | Hiermee haalt u een lijst met de tien belangrijkste partijen op op basis van het aantal treffers dat in verschillende categorieën is ontvangen. Deze query kan worden bewerkt om de trend van gebruik voor een bepaalde partij bij te houden. |
Alle bovenstaande query's kunnen worden gebruikt als basisquery's om aangepaste query's te maken in een Log Analytics-werkruimte. Deze lijst met query's kan ook worden geopend op het Logs tabblad in uw Azure Data Manager for Agriculture-resource in Azure Portal.
Volgende stappen
Meer informatie over het instellen van privékoppelingen.