Azure Data Manager for Agriculture naplózás

Miután létrehozott egy Data Manager for Agriculture erőforráspéldányt, megfigyelheti, hogy az erőforrások hogyan és mikor férnek hozzá, és ki által. Az adatsík-kérelmek sikertelenségének okait is elháríthatja. Ehhez engedélyeznie kell a naplózást az Azure Data Manager for Agriculture esetében. Ezután mentheti a naplóadatokat egy célhelyre, például egy tárfiókba, egy eseményközpontba vagy egy ön által megadott log analytics-munkaterületre.

Ez a cikk az Azure Data Manager for Agriculture naplózási beállításának lépéseit ismerteti.

Naplók gyűjtésének engedélyezése

A Data Manager for Agriculture szolgáltatás erőforrásának létrehozása után keresse meg a diagnosztikai beállításokat, majd válassza a lehetőséget add diagnostics settings. A naplók gyűjtésének és tárolásának megkezdéséhez kövesse az alábbi lépéseket:

1. Adja meg a diagnosztikai beállítás nevét.
2. Válassza ki azokat a kategóriákat, amelyekhez naplókat szeretne gyűjteni.
3. Válassza ki a tárfiókból, eseményközpontból vagy naplóelemzési munkaterületről történő gyűjtemény célját.

Most a diagnosztikai beállításban megadott célhelyre navigálhat a naplók eléréséhez. A naplózási adatokat a Data Manager for Agriculture művelet után 10 perccel (legfeljebb) érheti el. A legtöbb esetben gyorsabb.

Naplók értelmezése

Minden napló a táblázatban felsorolt sémát követi. A tábla a mezőneveket és a leírásokat tartalmazza:

Mezőnév	Leírás
Idő	Dátum és idő (UTC).
resourceId	Azure Resource Manager-erőforrás-azonosító. A naplók esetében ez a Data Manager for Agriculture erőforrás-azonosítója.
operationName	A művelet neve dokumentált módon.
operationVersion	AZ ügyfél által kért REST API-verzió.
Kategória	Az eredmény típusa.
resultType	A REST API-kérés eredménye (sikeres vagy sikertelen).
resultSignature	A HTTP-állapot.
resultDescription	További leírás az eredményről, ha elérhető.
durationMs	A REST API-kérelem végrehajtásának ideje ezredmásodpercben.
callerIpAddress	A kérést küldő ügyfél IP-címe.
Szinten	Az esemény súlyossági szintje (tájékoztató, figyelmeztetés, hiba vagy kritikus).
correlationId	Nem kötelező GUID, amely a naplók korrelálásához használható.
Identitás	Identitás a REST API-kérésben bemutatott jogkivonatból. Ez általában egy objektumazonosító és egy alkalmazásazonosító, vagy a kettő bármelyike.
hely	Az eseményt kibocsátó erőforrás régiója, például az "USA keleti régiója"
Tulajdonságok	Mindegyikhez operationName a következők tartoznak: requestUri (az API-kérés URI-ja), partyId(a kérelemhez társított partyId, ahol alkalmazható),dataPlaneResourceId (a kérelemben szereplő adatsík-erőforrás egyedi azonosítóját azonosító azonosító azonosító) és requestBody (tartalmazza az ApplicationAuditLogstól eltérő összes kategóriához operationName tartozó API-hívás kérelemtörzsét). A kategória előtt jobProcessesLogs említett általánostól eltérően: 1. Ez a lista az operationNames mezőiből áll: jobRunType (lehet egyszeri vagy időszakos), jobId (a feladat azonosítója), (azt jelzi, initiatedBy hogy egy feladatot egy felhasználó vagy a szolgáltatás aktivált-e). 2. Ez a lista a sikertelen farmoperációval kapcsolatos feladatok mezőit tartalmazza: farmOperationEntityId (annak az entitásnak az azonosítója, amelyet a farmOperation-feladat nem hozott létre), farmOperationEntityType(annak az entitásnak a típusa, amely nem jött létre), errorCode(feladathiba kódja), errorMessage(a hiba leírása), internalErrorCode(a szolgáltató által megadott hibakód), internalErrorMessage(a szolgáltató által megadott hiba leírása), providerId(a szolgáltató azonosítója).

A categories Data Manager for Agriculture mezője az alábbi táblázatban felsorolt értékekkel rendelkezhet:

Kategóriák tábla

kategória	Leírás
FarmManagementLogs	CruD-műveletek naplói parti, farm, mező, szezonális mező, termés, CropVariety, Season, Attachment, vényköteles térképek, receptek, felügyeleti zónák, zónák, növényi szövetelemzés és tápanyag-elemzésekhez.
FarmOperationsLogs	CruD-műveletek naplói FarmOperations adatbetöltési feladathoz, ApplicationData, PlantingData, HarvestingData, TillageData
SatelliteLogs	Naplók a műholdas adatbetöltési feladathoz tartozó műveletek létrehozásához és lekéréséhez
WeatherLogs	Naplók az időjárási adatbetöltési feladat létrehozásához, törléséhez és lekéréséhez
ProviderAuthLogs	Naplók az Oauth-szolgáltatók létrehozásához, frissítéséhez, törléséhez, kaszkádolt törléséhez, lekéréséhez és lekéréséhez. Emellett naplókkal is rendelkezik az oauth-jogkivonatok lekéréséhez, lekéréséhez és kaszkádolt törléséhez.
JobProcessedLogs	Naplók a feladatok sikerességének vagy sikertelenségének, illetve a hiba okának jelzésére. Az erőforrás-kaszkádolt törlési feladatok, adatbetöltési feladatok naplói mellett a farmműveletek és az eseménykezelési feladatok naplóit is tartalmazza.
ModelInferenceLogs	Naplók a biomasszamodell-feladat létrehozásához és lekéréséhez.
InsightLogs	Naplók az elemzések összes műveletének lekéréséhez és lekéréséhez.
ApplicationAuditLogs	Naplók olyan kiemelt műveletekhez, mint az adatsík-erőforrás létrehozása, frissítése, törlése és előfizetés-kezelési műveletek. A teljes lista az alábbi műveletnévtáblában található.

A operationName mezőértékek Microsoft.AgFoodPlatform/resource-name/read vagy write vagy delete vagy action formátumban vannak.

• /write a műveletnév utótagja az erőforrásnév létrehozásának vagy frissítésének felel meg
• /reada műveletnév utótagja a GET/LIST /GET ALL API-hívásoknak vagy az erőforrásnév kaszkádolt törlési feladatÁNAK GET állapotának felel meg
• /delete utótag az erőforrásnév törlésének felel meg
• /action utótag az erőforrásnév POST metódushívásainak felel meg
• /processed az utótag egy feladat (PUT metódushívás) befejezésének felel meg. Ez a feladat állapotát jelzi (sikeres vagy sikertelen).
• /failures az utótag egy farmműveleti feladat (PUT metódushívás) sikertelenségének felel meg, és a hiba okának leírását tartalmazza.

A feladatokra vonatkozó nómenklatúra a következő:

• Adatbetöltési feladatok esetén: Microsoft.AgFoodPlatform/ingestionJobs/<'resource-name'DataingestionJobs>/write
• Törlési feladatok esetén: Microsoft.AgFoodPlatform/deletionJobs/<'resource-name'cascadeDeleteJobs>/write

Az alábbi táblázat a kategória operationName értékeit és a hozzájuk tartozó REST API-parancsokat sorolja fel lapként:

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/mező/írás
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/prescriptions/write
Microsoft.AgFoodPlatform/prescriptions/read
Microsoft.AgFoodPlatform/prescriptions/delete
Microsoft.AgFoodPlatform/deletionJobs/prescriptionsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/prescription Térképek/write
Microsoft.AgFoodPlatform/prescription Térképek/read
Microsoft.AgFoodPlatform/prescription Térképek/delete
Microsoft.AgFoodPlatform/deletionJobs/prescription Térképek 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//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/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 Térképek 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

A más kategóriákban található írási és törlési naplók is szerepelnek ebben a kategóriában. Az ebben a kategóriában lévő naplók és az ugyanazon API-híváshoz tartozó egyéb kategóriák közötti különbség az, hogy az ApplicationAuditLogs nem naplózza a kérelemtörzset, míg más kategóriákban a kérelemtörzset. A korrelációs azonosítóval két különböző kategória naplóit kapcsolhatja össze további részletekért. Az alábbiakban felsorolunk néhány olyan vezérlősík-műveletet, amely nem része a többi kategóriának.

operationName
Data Manager létrehozása mezőgazdasági erőforráshoz
Data Manager frissítése mezőgazdasági erőforráshoz
Data Manager törlése mezőgazdasági erőforráshoz
Előfizetés létrehozása
Előfizetés frissítése
Adatsík-hitelesítés

Erőforrásnaplók lekérdezése log analytics-munkaterületen

Az categories összes erőforrásnapló táblaként van leképezve a log analyticsben. Az egyes kategóriák naplóinak eléréséhez létre kell hoznia egy diagnosztikai beállítást, amely adatokat küld egy log analytics-munkaterületre. Ezen a munkaterületen a felsorolt táblák bármelyikét lekérdezheti a megfelelő naplók lekéréséhez.

A log analytics tábláinak listája és az erőforrásnaplók kategóriáihoz való leképezésük

Táblanév a log analyticsben	Kategóriák az erőforrásnaplókban	Leírás
AgriFoodFarmManagementLogs	FarmManagementLogs	CruD-műveletek naplói parti, farm, mező, szezonális mező, termés, CropVariety, Season, Attachment, vényköteles térképek, receptek, felügyeleti zónák, zónák, növényi szövetelemzés és tápanyag-elemzésekhez.
AgriFoodFarmOperationsLogs	FarmOperationsLogs	CruD-műveletek naplói FarmOperations adatbetöltési feladathoz, ApplicationData, PlantingData, HarvestingData, TillageData.
AgriFoodSatelliteLogs	SatelliteLogs	Naplók a műholdas adatbetöltési feladathoz szükséges műveletek létrehozásához és lekéréséhez.
AgriFoodWeatherLogs	WeatherLogs	Naplók az időjárási adatbetöltési feladat létrehozásához, törléséhez és lekéréséhez.
AgriFoodProviderAuthLogs	ProviderAuthLogs	Naplók a létrehozáshoz, frissítéshez, törléshez, kaszkádolt törléshez, lekéréshez és lekéréshez az oauth-szolgáltatók számára. Emellett naplókkal is rendelkezik az oauth-jogkivonatok lekéréséhez, lekéréséhez és kaszkádolt törléséhez.
AgriFoodInsightLogs	InsightLogs	Naplók az elemzések összes műveletének lekéréséhez és lekéréséhez.
AgriFoodModelInferenceLogs	ModelInferenceLogs	Naplók a biomasszamodell-feladat létrehozásához és lekéréséhez.
AgriFoodJobProcessedLogs	JobProcessedLogs	Naplók a feladatok sikerességének vagy sikertelenségének, illetve a hiba okának jelzésére. Az erőforrás-kaszkádolt törlési feladatok naplói mellett adatbetöltési feladatok is. Emellett a farmműveletek és az eseménykezelési feladatok naplóit is tartalmazza.
AgriFoodApplicationAuditLogs	ApplicationAuditLogs	Naplók olyan kiemelt műveletekhez, mint az adatsík-erőforrás létrehozása, frissítése, törlése és előfizetés-kezelési műveletek.

Log Analytics-táblák oszlopainak listája

Mezőnév	Leírás
Idő	Dátum és idő (UTC).
ResourceId	Azure Resource Manager-erőforrás-azonosító a Data Manager for Agriculture naplóihoz.
OperationName	A művelet neve a korábbi táblázatban dokumentált módon.
OperationVersion	AZ ügyfél által kért REST API-verzió.
Category	A Data Manager for Agriculture naplóiban szereplő kategóriaadatok bármilyen értéket tartalmazhatnak a kategóriatáblában felsoroltak szerint.
ResultType	A REST API-kérés eredménye (sikeres vagy sikertelen).
ResultSignature	A HTTP-állapot.
ResultDescription	Ha elérhető, további leírás az eredményről.
DurationMs	A REST API-kérelem végrehajtásának ideje ezredmásodpercben.
CallerIpAddress	A kérést küldő ügyfél IP-címe.
Szint	Az esemény súlyossági szintje (tájékoztató, figyelmeztetés, hiba vagy kritikus).
Korrelációs azonosító	Nem kötelező GUID, amely a naplók korrelálásához használható.
ApplicationId	A hívó identitását jelző alkalmazásazonosító.
ObjectId	A hívó identitását jelző objektumazonosító.
ClientTenantId	A hívó bérlőjének azonosítója.
SubscriptionId	A hívó által használt előfizetés azonosítója.
Tartózkodási hely	Az eseményt kibocsátó erőforrás régiója, például az "USA keleti régiója"
JobRunType	Csak a táblában AgriFoodJobProcessesLogs érhető el, a feladatfuttatás típusát jelzi. Az érték lehet periodikus vagy egyszeri.
Feladatazonosító	AgriFoodJobProcessesLogsA rendelkezésre álló , AgriFoodSatelliteLogsés AgriFoodWeatherLogsAgriFoodModelInferenceLogs, a feladat azonosítóját jelzi.
InitiatedBy	Csak a táblában AgriFoodJobProcessesLogs érhető el. Azt jelzi, hogy a feladatot egy felhasználó vagy a szolgáltatás kezdeményezte-e.
partyId	A művelethez társított fél azonosítója.
Tulajdonságok	Csak a táblábanAgriFoodJobProcessesLogs érhető el, a következőt tartalmazza: farmOperationEntityId (annak az entitásnak az azonosítója, amelyet a farmOperation-feladat nem hozott létre), farmOperationEntityType(A nem létrehozandó entitás típusa lehet ApplicationData, PeriodicJob stb.), errorCode(A Data Manager for Agriculture end feladat sikertelenségének kódja)errorMessage(A data manager for Agriculture-feladat végén található hiba leírása)internalErrorCode(A szolgáltató által megadott feladat sikertelenségének kódja), internalErrorMessage(A szolgáltató által megadott hiba leírása)providerId(a szolgáltató azonosítója, például JOHN-D Enterprise kiadás RE).

Ezek a táblák naplóelemzési munkaterület létrehozásával kérdezhetők le. Itt található a lekérdezési nyelvre vonatkozó hivatkozás.

Minta lekérdezések listája a Log Analytics-munkaterületen

Lekérdezés neve	Leírás
Egy fél farmkezelési műveleteinek állapota	Lekéri az egyes felek kategórián belüli FarmManagementLogs sikeres és sikertelen műveleteinek számát.
Feladatvégrehajtási statisztikák egy fél számára	A kategóriában szereplő összes művelet sikeres és sikertelen műveleteinek számát adja meg az JobProcessedLogs egyes felek számára.
Sikertelen engedélyezés	Azonosítja azoknak a felhasználóknak a listáját, akik nem fértek hozzá az erőforráshoz, és a hiba okát.
Egy fél összes műveletének állapota	Összesíti a hibákat és a sikereket egy fél kategóriáiban.
A 100 legjobb fél használati trendjei az elvégzett műveletek alapján	Lekéri a 100 legjobb párt listáját a kategóriák között kapott találatok száma alapján. Ez a lekérdezés szerkeszthető egy adott fél használati trendjének nyomon követéséhez.

A fent felsorolt összes lekérdezés használható alap lekérdezésként egyéni lekérdezések létrehozásához egy log analytics-munkaterületen. A lekérdezések listája az Logs Azure Portal Azure Data Manager for Agriculture-erőforrásának lapján is elérhető.

Következő lépések

Megtudhatja, hogyan állíthat be privát hivatkozásokat.