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:
- Berikan nama untuk pengaturan diagnostik.
- Pilih kategori yang ingin Anda mulai kumpulkan lognya.
- 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 .
/writeakhiran 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/deleteakhiran sesuai dengan penghapusan nama sumber daya/actionakhiran sesuai dengan panggilan metode POST untuk nama sumber daya/processedakhiran sesuai dengan penyelesaian pekerjaan (panggilan metode PUT). Ini menunjukkan status pekerjaan (berhasil atau gagal)./failuresakhiran 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/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/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/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
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.
Catatan
Untuk melakukan panggilan sarana kontrol, Anda memerlukan akses pemilik pada cakupan sumber daya ADMA.
| 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. |
| Golongan | 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. |
| Location | 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.