Pengelogan Azure Data Manager for Agriculture

Setelah membuat instans sumber daya Data Manager for Agriculture, Anda dapat memantau bagaimana dan kapan sumber daya Anda diakses, dan oleh siapa. Anda juga dapat men-debug alasan kegagalan untuk permintaan data-plane. Untuk melakukan ini, Anda perlu mengaktifkan pengelogan untuk Azure Data Manager for Agriculture. Anda kemudian dapat menyimpan informasi log di tujuan seperti akun penyimpanan, pusat aktivitas, atau ruang kerja analitik log, yang Anda sediakan.

Artikel ini memberi Anda langkah-langkah untuk menyiapkan pengelogan untuk Azure Data Manager for Agriculture.

Mengaktifkan pengumpulan log

Setelah membuat sumber daya layanan Data Manager for Agriculture, navigasikan ke pengaturan diagnostik lalu pilih add diagnostics settings. Ikuti langkah-langkah berikut untuk mulai mengumpulkan dan menyimpan log:

1. Berikan nama untuk pengaturan diagnostik.
2. Pilih kategori yang ingin Anda mulai kumpulkan lognya.
3. Pilih tujuan pengumpulan dari akun penyimpanan, pusat aktivitas, atau ruang kerja analitik log.

Sekarang Anda dapat menavigasi ke tujuan yang Anda tentukan dalam pengaturan diagnostik untuk mengakses log. Anda dapat mengakses informasi pengelogan 10 menit (paling lama) setelah operasi Data Manager for Agriculture. Dalam kebanyakan kasus, itu lebih cepat.

Menginterpretasikan log Anda

Setiap log mengikuti skema yang tercantum dalam tabel. Tabel berisi nama bidang dan deskripsi:

Nama bidang	Deskripsi
time	Tanggal dan waktu di UTC.
resourceId	ID sumber daya Azure Resource Manager. Untuk log, ini adalah ID sumber daya Data Manager for Agriculture.
operationName	Nama operasi, seperti yang didokumentasikan.
operationVersion	Versi REST API yang diminta oleh klien.
category	Jenis hasil.
resultType	Hasil permintaan REST API (berhasil atau gagal).
resultSignature	Status HTTP.
resultDescription	Deskripsi tambahan tentang hasilnya, jika tersedia.
durationMs	Waktu yang diperlukan untuk melayani permintaan REST API, dalam milidetik.
callerIpAddress	Alamat IP klien yang membuat permintaan.
tingkat	Tingkat keparahan peristiwa (Informasi, Peringatan, Kesalahan, atau Kritis).
correlationId	GUID opsional yang dapat digunakan untuk menghubungkan log.
identitas	Identitas dari token yang disajikan dalam permintaan REST API. Ini biasanya ID objek dan ID aplikasi atau salah satu dari keduanya.
Lokasi	Wilayah sumber daya yang memancarkan peristiwa seperti "US Timur"
properties	Untuk setiap operationName ini berisi: requestUri (URI permintaan API), partyId(partyId yang terkait dengan permintaan, di mana pun berlaku),dataPlaneResourceId (ID yang secara unik mengidentifikasi sumber daya data-plane dalam permintaan) dan requestBody (berisi isi permintaan untuk panggilan API yang terkait dengan operationName untuk semua kategori selain ApplicationAuditLogs). Selain yang umum disebutkan sebelum jobProcessesLogs kategori memiliki: 1. Daftar ini berisi bidang di seluruh operationNames: jobRunType (dapat berupa oneTime atau periodic), jobId (ID pekerjaan), initiatedBy (menunjukkan apakah pekerjaan dipicu oleh pengguna atau oleh layanan). 2. Daftar ini adalah bidang untuk pekerjaan terkait farmOperation yang gagal: farmOperationEntityId (ID entitas yang gagal dibuat oleh pekerjaan farmOperation), farmOperationEntityType(jenis entitas yang gagal dibuat), errorCode(kode untuk kegagalan pekerjaan), errorMessage(deskripsi kegagalan), internalErrorCode(kode kegagalan disediakan oleh penyedia), internalErrorMessage(deskripsi kegagalan yang disediakan oleh penyedia), (deskripsi kegagalan yang disediakan oleh penyedia), providerId(ID penyedia).

Bidang categories untuk Manajer Data untuk Pertanian bisa memiliki nilai yang tercantum dalam tabel berikut ini:

Tabel kategori

category	Deskripsi
FarmManagementLogs	Log untuk operasi CRUD untuk pesta, Farm, Bidang, Bidang Musiman, Tanaman, CropVariety, Musim, Lampiran, peta resep, resep, zona manajemen, zona, analisis jaringan tanaman dan analisis nutrisi.
FarmOperationsLogs	Log untuk operasi CRUD untuk pekerjaan penyerapan data FarmOperations, ApplicationData, PlantingData, HarvestingData, TillageData
SatelitLogs	Log untuk membuat dan mendapatkan operasi untuk pekerjaan penyerapan data Satelit
WeatherLogs	Log untuk membuat, menghapus, dan mendapatkan operasi untuk pekerjaan penyerapan data cuaca
ProviderAuthLogs	Log untuk membuat, memperbarui, menghapus, menghapus bertahap, mendapatkan, dan mendapatkan semua untuk penyedia Oauth. Ini juga memiliki log untuk mendapatkan, mendapatkan semua, menghapus kaskade untuk token oauth.
JobProcessedLogs	Log untuk menunjukkan keberhasilan atau kegagalan dan alasan kegagalan untuk pekerjaan. Selain log untuk pekerjaan penghapusan kaskade sumber daya, pekerjaan penyerapan data, itu juga berisi log untuk operasi farm dan pekerjaan penanganan peristiwa.
ModelInferenceLogs	Log untuk membuat dan mendapatkan operasi untuk pekerjaan model biomassa.
InsightLogs	Log untuk mendapatkan dan mendapatkan semua operasi untuk wawasan.
ApplicationAuditLogs	Log untuk tindakan istimewa seperti membuat sumber daya bidang data, memperbarui, menghapus, dan operasi manajemen langganan. Daftar lengkap ada dalam tabel nama operasi di bawah ini.

Nilai operationName bidang berada dalam format Microsoft.AgFoodPlatform/resource-name/read atau write atau delete atau action .

• /write akhiran dalam nama operasi sesuai dengan buat atau perbarui nama sumber daya
• /readakhiran dalam nama operasi sesuai dengan panggilan GET/ LIST /GET ALL API atau status GET untuk pekerjaan penghapusan kaskade untuk nama sumber daya
• /delete akhiran sesuai dengan penghapusan nama sumber daya
• /action akhiran sesuai dengan panggilan metode POST untuk nama sumber daya
• /processed akhiran sesuai dengan penyelesaian pekerjaan (panggilan metode PUT). Ini menunjukkan status pekerjaan (berhasil atau gagal).
• /failures akhiran sesuai dengan kegagalan pekerjaan operasi farm (panggilan metode PUT) dan berisi deskripsi tentang alasan kegagalan.

Nomenklatur untuk Pekerjaan adalah sebagai berikut:

• Untuk pekerjaan penyerapan data: Microsoft.AgFoodPlatform/ingestionJobs/<'resource-name'DataingestionJobs>/write
• Untuk pekerjaan penghapusan: Microsoft.AgFoodPlatform/deletionJobs/<'resource-name'cascadeDeleteJobs>/write

Tabel berikut mencantumkan nilai operationName dan perintah REST API terkait untuk kategori sebagai tab:

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/prescriptions/write
Microsoft.AgFoodPlatform/prescriptions/read
Microsoft.AgFoodPlatform/prescriptions/delete
Microsoft.AgFoodPlatform/deletionJobs/prescriptionsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/prescription Peta/write
Microsoft.AgFoodPlatform/prescription Peta/read
Microsoft.AgFoodPlatform/prescription Peta/delete
Microsoft.AgFoodPlatform/deletionJobs/prescription Peta 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/plantTissueanalysesCascadeleteJobs/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

SatelitLogs

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/prescription Peta 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

Log tulis dan hapus yang ada di kategori lain juga ada dalam kategori ini. Perbedaan antara log dalam kategori ini dan kategori lain untuk panggilan API yang sama adalah bahwa, ApplicationAuditLogs tidak mencatat isi permintaan, sementara dalam kategori lain isi permintaan diisi. Gunakan correlation-id untuk menghubungkan log dari dua kategori berbeda untuk mendapatkan detail selengkapnya. Beberapa operasi sarana kontrol yang bukan bagian dari kategori lainnya tercantum di bawah ini.

operationName
Membuat Manajer Data untuk Sumber Daya Pertanian
Memperbarui Data Manager untuk Sumber Daya Pertanian
Menghapus Manajer Data untuk Sumber Daya Pertanian
Buat Langganan
Perbarui Langganan
Autentikasi Data Plane

Mengkueri log sumber daya di ruang kerja analitik log

categories Semua log sumber daya dipetakan sebagai tabel dalam analitik log. Untuk mengakses log untuk setiap kategori, Anda perlu membuat pengaturan diagnostik untuk mengirim data ke ruang kerja analitik log. Di ruang kerja ini, Anda bisa mengkueri salah satu tabel yang tercantum untuk mendapatkan log yang relevan.

Daftar tabel dalam analitik log dan pemetaannya ke kategori dalam log sumber daya

Nama tabel dalam analitik log	Kategori dalam log sumber daya	Deskripsi
AgriFoodFarmManagementLogs	FarmManagementLogs	Log untuk operasi CRUD untuk pesta, Farm, Bidang, Bidang Musiman, Tanaman, CropVariety, Musim, Lampiran, peta resep, resep, zona manajemen, zona, analisis jaringan tanaman dan analisis nutrisi.
AgriFoodFarmOperationsLogs	FarmOperationsLogs	Log untuk operasi CRUD untuk pekerjaan penyerapan data FarmOperations, ApplicationData, PlantingData, HarvestingData, TillageData.
AgriFoodSatelliteLogs	SatelitLogs	Log untuk membuat dan mendapatkan operasi untuk pekerjaan penyerapan data satelit.
AgriFoodWeatherLogs	WeatherLogs	Log untuk membuat, menghapus, dan mendapatkan operasi untuk pekerjaan penyerapan data cuaca.
AgriFoodProviderAuthLogs	ProviderAuthLogs	Log untuk membuat, memperbarui, menghapus, menghapus kaskade, mendapatkan, dan mendapatkan semua untuk penyedia oauth. Ini juga memiliki log untuk mendapatkan, mendapatkan semua, menghapus kaskade untuk token oauth.
AgriFoodInsightLogs	InsightLogs	Log untuk mendapatkan dan mendapatkan semua operasi untuk wawasan.
AgriFoodModelInferenceLogs	ModelInferenceLogs	Log untuk membuat dan mendapatkan operasi untuk pekerjaan model biomassa.
AgriFoodJobProcessedLogs	JobProcessedLogs	Log untuk menunjukkan keberhasilan atau kegagalan dan alasan kegagalan untuk pekerjaan. Selain log untuk pekerjaan penghapusan kaskade sumber daya, pekerjaan penyerapan data. Ini juga berisi log untuk operasi farm dan pekerjaan penanganan peristiwa.
AgriFoodApplicationAuditLogs	ApplicationAuditLogs	Log untuk tindakan istimewa seperti membuat sumber daya bidang data, memperbarui, menghapus, dan operasi manajemen langganan.

Daftar kolom dalam tabel analitik log

Nama bidang	Deskripsi
Waktu	Tanggal dan waktu di UTC.
ResourceId	ID sumber daya Azure Resource Manager untuk log Data Manager for Agriculture.
OperationName	Nama operasi, seperti yang didokumentasikan dalam tabel sebelumnya.
OperationVersion	Versi REST API yang diminta oleh klien.
Kategori	Detail kategori dalam log Data Manager for Agriculture, ini bisa menjadi nilai apa pun seperti yang tercantum dalam tabel kategori.
ResultType	Hasil permintaan REST API (berhasil atau gagal).
ResultSignature	Status HTTP.
ResultDescription	Deskripsi selengkapnya tentang hasilnya, jika tersedia.
DurasiM	Waktu yang diperlukan untuk melayani permintaan REST API, dalam milidetik.
CallerIpAddress	Alamat IP klien yang membuat permintaan.
Tingkat	Tingkat keparahan peristiwa (informasi, peringatan, kesalahan, atau kritis).
CorrelationId	GUID opsional yang dapat digunakan untuk menghubungkan log.
ApplicationId	ID aplikasi yang menunjukkan identitas pemanggil.
ObjectId	ID objek yang menunjukkan identitas pemanggil.
ClientTenantId	ID penyewa pemanggil.
SubscriptionId	ID langganan yang digunakan oleh pemanggil.
Lokasi	Wilayah sumber daya yang memancarkan peristiwa seperti "US Timur"
JobRunType	Hanya tersedia dalam AgriFoodJobProcessesLogs tabel, menunjukkan jenis pekerjaan yang dijalankan. Nilai dapat berupa berkala atau satu kali.
JobId	Tersedia diAgriFoodJobProcessesLogs, AgriFoodSatelliteLogs, AgriFoodWeatherLogs, dan AgriFoodModelInferenceLogs, menunjukkan ID pekerjaan.
InitiatedBy	Hanya tersedia dalam AgriFoodJobProcessesLogs tabel. Menunjukkan apakah pekerjaan dimulai oleh pengguna atau oleh layanan.
partyId	ID pihak yang terkait dengan operasi.
Properti	Hanya tersedia dalamAgriFoodJobProcessesLogs tabel, berisi: farmOperationEntityId (ID entitas yang gagal dibuat oleh pekerjaan farmOperation), farmOperationEntityType(Jenis entitas yang gagal dibuat, dapat berupa ApplicationData, PeriodicJob, dll.), errorCode(Kode untuk kegagalan pekerjaan di Manajer Data untuk akhir Pertanian),errorMessage(Deskripsi kegagalan di Manajer Data untuk akhir Pertanian),internalErrorCode(Kode kegagalan pekerjaan yang disediakan oleh penyedia), internalErrorMessage(Deskripsi kegagalan yang disediakan oleh penyedia),providerId (ID penyedia seperti JOHN-DEERE).

Masing-masing tabel ini dapat dikueri dengan membuat ruang kerja analitik log. Referensi untuk bahasa kueri ada di sini.

Daftar kueri sampel di ruang kerja analitik log

Nama kueri	Deskripsi
Status operasi manajemen farm untuk suatu pihak	Mengambil hitungan keberhasilan dan kegagalan operasi dalam FarmManagementLogs kategori untuk setiap pihak.
Statistik eksekusi pekerjaan untuk suatu pihak	Memberikan hitungan keberhasilan dan kegagalan untuk semua operasi dalam JobProcessedLogs kategori untuk setiap pihak.
Otorisasi Gagal	Mengidentifikasi daftar pengguna yang gagal mengakses sumber daya Anda dan alasan kegagalan ini.
Status semua operasi untuk pihak	Mengagregasi kegagalan dan keberhasilan di seluruh kategori untuk pesta.
Tren penggunaan untuk 100 pihak teratas berdasarkan operasi yang dilakukan	Mengambil daftar 100 pihak teratas berdasarkan jumlah temuan yang diterima di seluruh kategori. Kueri ini dapat diedit untuk melacak tren penggunaan untuk pihak tertentu.

Semua kueri yang tercantum di atas dapat digunakan sebagai kueri dasar untuk membentuk kueri kustom di ruang kerja analitik log. Daftar kueri ini juga dapat diakses di Logs tab di sumber daya Azure Data Manager for Agriculture Anda di portal Azure.

Langkah berikutnya

Pelajari cara menyiapkan tautan privat.