Protokolování Azure Data Manageru pro zemědělství

Po vytvoření instance prostředku Data Manager for Agriculture můžete sledovat, jak a kdy se k prostředkům přistupuje a kdo. Můžete také ladit důvody selhání požadavků roviny dat. K tomu je potřeba povolit protokolování pro Azure Data Manager pro zemědělství. Potom můžete uložit informace protokolu do cílového umístění, jako je účet úložiště, centrum událostí nebo pracovní prostor služby Log Analytics, který zadáte.

Tento článek obsahuje postup nastavení protokolování pro Azure Data Manager pro zemědělství.

Povolení shromažďování protokolů

Po vytvoření prostředku služby Data Manager for Agriculture přejděte do nastavení diagnostiky a pak vyberte add diagnostics settings. Pokud chcete začít shromažďovat a ukládat protokoly, postupujte takto:

1. Zadejte název nastavení diagnostiky.
2. Vyberte kategorie, pro které chcete začít shromažďovat protokoly.
3. Vyberte cíl kolekce z účtu úložiště, centra událostí nebo pracovního prostoru služby Log Analytics.

Teď můžete přejít do cíle, který jste zadali v nastavení diagnostiky, a získat přístup k protokolům. K informacím o protokolování se dostanete maximálně 10 minut po operaci Data Manageru pro zemědělství. Ve většině případů je to rychlejší.

Interpretace protokolů

Každý protokol se řídí schématem uvedeným v tabulce. Tabulka obsahuje názvy a popisy polí:

Název pole	Popis
Čas	Datum a čas v UTC.
resourceId	ID prostředku Azure Resource Manageru V protokolech se jedná o ID prostředku Data Manager for Agriculture.
operationName	Název operace, jak je uvedeno v dokumentu
operationVersion	Verze rozhraní REST API požadovaná klientem
kategorie	Typ výsledku
resultType	Výsledek požadavku rozhraní REST API (úspěch nebo selhání)
resultSignature	Stav HTTP.
resultDescription	Další popis výsledku, pokud je k dispozici.
durationMs	Doba trvání obsloužení požadavku REST API v milisekundách.
callerIpAddress	IP adresa klienta, který požadavek provedl.
úroveň	Úroveň závažnosti události (informační, upozornění, chyba nebo kritická)
correlationId	Volitelný identifikátor GUID, který lze použít ke korelaci protokolů.
identita	Identita z tokenu, který se zobrazil v požadavku rozhraní REST API. Obvykle se jedná o ID objektu a ID aplikace nebo jednu z těchto dvou.
location	Oblast prostředku vygenerující událost, například USA – východ
vlastnosti	Pro každou operationName z těchto možností obsahuje: requestUri (identifikátor URI požadavku rozhraní API), partyId(id strany přidružené k požadavku, kdykoli je to možné),dataPlaneResourceId (ID, které jednoznačně identifikuje prostředek roviny dat v požadavku) a requestBody (obsahuje tělo požadavku pro volání rozhraní API přidružené operationName pro všechny jiné kategorie než ApplicationAuditLogs). Jiná než společná zmínka před jobProcessesLogs kategorií má: 1. Tento seznam obsahuje pole mezi názvy operací: jobRunType (může to být oneTime nebo periodická), jobId (ID úlohy) initiatedBy (označuje, jestli byla úloha aktivována uživatelem nebo službou). 2. Tento seznam obsahuje pole pro neúspěšné úlohy související s farmOperation: farmOperationEntityId (ID entity, která se nepodařilo vytvořit úlohou farmOperation), farmOperationEntityType(typ entity, která se nepodařilo vytvořit), errorCode(kód selhání úlohy), errorMessage(popis selhání), internalErrorCode(kód chyby poskytnutý poskytovatelem), (popis selhání poskytnutého poskytovatelem), internalErrorMessageproviderId(ID poskytovatele).

Pole categories Data Manager pro zemědělství může obsahovat hodnoty uvedené v následující tabulce:

Tabulka Kategorií

category	Popis
FarmManagementLogs	Protokoly pro operace CRUD pro party, Farmu, Pole, Sezónní pole, Oříznutí, CropVariety, Season, Příloha, mapy předpisů, předpisy, zóny správy, zóny, analýzy rostlin a živiny.
FarmOperationsLogs	Protokoly pro operace CRUD pro úlohu ingestování dat FarmOperations, ApplicationData, PlantingData, ChycenáData, TillageData
Satelitnílogy	Protokoly pro vytvoření a získání operací pro úlohu příjmu satelitních dat
WeatherLogs	Protokoly pro vytváření, odstraňování a získávání operací pro úlohu příjmu dat o počasí
ProviderAuthLogs	Protokoly pro vytváření, aktualizaci, odstraňování, kaskádové odstranění, získání a získání všech zprostředkovatelů OAuth Obsahuje také protokoly pro získání, získání všech a kaskádové odstranění tokenů oauth.
JobProcessedLogs	Protokoly označující úspěch nebo selhání a důvod selhání úloh. Kroměprotokolůch
ModelInferenceLogs	Protokoly pro vytváření a získávání operací pro úlohu modelu biomasy.
InsightLogs	Protokoly pro získání a získání všech operací pro přehledy
ApplicationAuditLogs	Protokoly pro privilegované akce, jako jsou vytváření, aktualizace, odstraňování a operace správy předplatného, jako jsou prostředky roviny dat. Úplný seznam je v tabulce názvů operací níže.

Hodnoty operationName polí jsou ve formátu Microsoft.AgFoodPlatform/resource-name/read, write nebo delete nebo action .

• /write Přípona v názvu operace odpovídá vytvoření nebo aktualizaci názvu prostředku
• /readPřípona v názvu operace odpovídá voláním GET/ LIST /GET ALL API nebo stavu GET pro kaskádovou úlohu odstranění názvu prostředku.
• /delete Přípona odpovídá odstranění názvu prostředku.
• /action Přípona odpovídá volání metody POST pro název prostředku.
• /processed Přípona odpovídá dokončení úlohy (volání metody PUT). Označuje stav úlohy (úspěch nebo selhání).
• /failures Přípona odpovídá selhání úlohy operace farmy (volání metody PUT) a obsahuje popis důvodu selhání.

Terminologie pracovních míst je následující:

• Úlohy příjmu dat: Microsoft.AgFoodPlatform/ingestionJobs/<'resource-name'DataingestionJobs>/write
• Úlohy odstranění: Microsoft.AgFoodPlatform/deletionJobs/<'resource-name'cascadeDeleteJobs>/write

Následující tabulka uvádí hodnoty operationName a odpovídající příkazy rozhraní REST API pro kategorii jako kartu:

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/plodiny/read
Microsoft.AgFoodPlatform/plodiny/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/předpis/write
Microsoft.AgFoodPlatform/předpis/read
Microsoft.AgFoodPlatform/předpis/delete
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//deleteJobs/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/sběrData/write
Microsoft.AgFoodPlatform/chyceníData/read
Microsoft.AgFoodPlatform/chyceníData/delete
Microsoft.AgFoodPlatform/deletionJobs/chyceníDatacascadeDeletejob/write
Microsoft.AgFoodPlatform/tillageData/Write
Microsoft.AgFoodPlatform/tillageData/Read
Microsoft.AgFoodPlatform/tillageData/Delete
Microsoft.AgFoodPlatform/deletionJobs/tillageDatacascadeDeletejob/write

Satelitnílogy

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/biomasaModelJobs/zpracované
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

Protokoly zápisu a odstranění, které jsou přítomné v jiných kategoriích, jsou v této kategorii také přítomny. Rozdíl mezi protokoly v této kategorii a dalšími kategoriemi pro stejné volání rozhraní API spočívá v tom, že ApplicationAuditLogs protokoluje text požadavku, zatímco v jiných kategoriích se naplní text požadavku. Pokud chcete získat další podrobnosti, použijte ID korelace k propojení protokolů dvou různých kategorií. Některé z operací řídicí roviny, které nejsou součástí zbývajících kategorií, jsou uvedeny níže.

Poznámka:

Pro volání řídicí roviny potřebujete přístup vlastníka k rozsahu prostředků ADMA.

operationName
Vytvoření správce dat pro zemědělství
Aktualizace Data Manageru pro zemědělství
Odstranění správce dat pro zemědělství
Vytvoření předplatného
Aktualizace předplatného
Ověřování roviny dat

Dotazování protokolů prostředků v pracovním prostoru služby Log Analytics

categories Všechny protokoly prostředků se mapují jako tabulka v Log Analytics. Pokud chcete získat přístup k protokolům pro každou kategorii, musíte vytvořit nastavení diagnostiky pro odesílání dat do pracovního prostoru služby Log Analytics. V tomto pracovním prostoru se můžete dotazovat na libovolnou z uvedených tabulek, abyste získali příslušné protokoly.

Seznam tabulek v Log Analytics a jejich mapování na kategorie v protokolech prostředků

Název tabulky v Log Analytics	Kategorie v protokolech prostředků	Popis
AgriFoodFarmManagementLogs	FarmManagementLogs	Protokoly pro operace CRUD pro party, Farmu, Pole, Sezónní pole, Oříznutí, CropVariety, Season, Příloha, mapy předpisů, předpisy, zóny správy, zóny, analýzy rostlin a živiny.
AgriFoodFarmOperationsLogs	FarmOperationsLogs	Protokoly pro operace CRUD pro úlohu ingestování dat FarmOperations, ApplicationData, PlantingData, ChyceníData, TillageData.
AgriFoodSatelliteLogs	Satelitnílogy	Protokoly pro vytvoření a získání operací pro úlohu příjmu satelitních dat
AgriFoodWeatherLogs	WeatherLogs	Protokoly pro vytváření, odstraňování a získávání operací pro úlohu příjmu dat o počasí
AgriFoodProviderAuthLogs	ProviderAuthLogs	Protokoly pro vytváření, aktualizaci, odstraňování, kaskádové odstranění, získání a získání všech zprostředkovatelů oauth Obsahuje také protokoly pro získání, získání všech a kaskádové odstranění tokenů oauth.
AgriFoodInsightLogs	InsightLogs	Protokoly pro získání a získání všech operací pro přehledy
AgriFoodModelInferenceLogs	ModelInferenceLogs	Protokoly pro vytváření a získávání operací pro úlohu modelu biomasy.
AgriFoodJobProcessedLogs	JobProcessedLogs	Protokoly označující úspěch nebo selhání a důvod selhání úloh. Kroměprotokolůch Obsahuje také protokoly pro operace farmy a úlohy zpracování událostí.
AgriFoodApplicationAuditLogs	ApplicationAuditLogs	Protokoly pro privilegované akce, jako jsou vytváření, aktualizace, odstraňování a operace správy předplatného, jako jsou prostředky roviny dat.

Seznam sloupců v tabulkách Log Analytics

Název pole	Popis
Time	Datum a čas v UTC.
ResourceId	ID prostředku Azure Resource Manageru pro protokoly Data Manageru pro zemědělství
Název operace	Název operace, jak je popsáno v předchozí tabulce.
OperationVersion	Verze rozhraní REST API požadovaná klientem
Kategorie	Podrobnosti o kategoriích v protokolech Data Manageru pro zemědělství můžou být libovolná hodnota uvedená v tabulce kategorií.
ResultType	Výsledek požadavku rozhraní REST API (úspěch nebo selhání)
ResultSignature	Stav HTTP.
ResultDescription	Další popis výsledku, pokud je k dispozici.
Doba trvání	Doba trvání obsloužení požadavku REST API v milisekundách.
CallerIpAddress	IP adresa klienta, který požadavek provedl.
Úroveň	Úroveň závažnosti události (informativní, upozornění, chyba nebo kritická)
Id korelace	Volitelný identifikátor GUID, který lze použít ke korelaci protokolů.
ApplicationId	ID aplikace označující identitu volajícího
Id objektu	ID objektu označující identitu volajícího.
ClientTenantId	ID tenanta volajícího
SubscriptionId	ID předplatného používaného volajícím
Místo	Oblast prostředku vygenerující událost, například USA – východ
JobRunType	K dispozici pouze v AgriFoodJobProcessesLogs tabulce označuje typ spuštění úlohy. Hodnota může být periodická nebo jednorázová.
Id úlohy	K dispozici vAgriFoodJobProcessesLogs , AgriFoodSatelliteLogs, AgriFoodWeatherLogsa AgriFoodModelInferenceLogs, označuje ID úlohy.
Inicializováno	K dispozici pouze v AgriFoodJobProcessesLogs tabulce. Určuje, jestli byla úloha inicializována uživatelem nebo službou.
partyId	ID strany přidružené k operaci.
Vlastnosti	K dispozici pouze vAgriFoodJobProcessesLogs tabulce, která obsahuje: farmOperationEntityId (ID entity, která se nepodařilo vytvořit úlohou farmOperation), farmOperationEntityType(typ entity, která se nepodařilo vytvořit, může to být ApplicationData, PeriodicJob atd.), errorCode(kód pro selhání úlohy na konci Data Manageru pro zemědělství),errorMessage(Popis selhání v Data Manageru pro zemědělství konec),internalErrorCode(Kód selhání úlohy poskytované poskytovatelem), internalErrorMessage(Popis selhání poskytnutého poskytovatelem),providerId(ID poskytovatele, jako je JOHN-DEERE).

Každá z těchto tabulek se dá dotazovat vytvořením pracovního prostoru služby Log Analytics. Tady najdete referenční informace pro dotazovací jazyk.

Seznam ukázkových dotazů v pracovním prostoru služby Log Analytics

Název dotazu	Popis
Stav operací správy farmy pro stranu	Načte počet úspěchů a selhání operací v kategorii FarmManagementLogs pro každou stranu.
Statistika provádění úloh pro stranu	Poskytuje počet úspěchů a selhání pro všechny operace v JobProcessedLogs kategorii pro každou stranu.
Neúspěšná autorizace	Identifikuje seznam uživatelů, kteří se nepodařilo získat přístup k vašemu prostředku, a důvod tohoto selhání.
Stav všech operací pro stranu	Agreguje selhání a úspěšnost napříč kategoriemi pro stranu.
Trendy využití pro prvních 100 stran na základě provedených operací	Načte seznam 100 nejdůležitějších stran na základě počtu přístupů přijatých napříč kategoriemi. Tento dotaz lze upravit tak, aby sledoval trend využití konkrétní strany.

Všechny výše uvedené dotazy lze použít jako základní dotazy k vytvoření vlastních dotazů v pracovním prostoru služby Log Analytics. Tento seznam dotazů je také přístupný na Logs kartě prostředku Azure Data Manageru pro zemědělství na webu Azure Portal.

Další kroky

Zjistěte, jak nastavit privátní propojení.