用於農業的 Azure 資料管理員記錄
建立用於農業的資料管理員資源執行個體後，您可以監視資源的存取方式和時間，以及由誰存取。 您也可以針對資料平面要求失敗的原因進行偵錯。 若要這樣做，您需要針對用於農業的 Azure 資料管理員啟用記錄。 然後，您可以在目的地儲存記錄資訊，例如儲存體帳戶、事件中樞或您提供的記錄分析工作區。
本文提供您為用於農業的 Azure 資料管理員設定記錄的步驟。
啟用記錄的集合
建立用於農業的資料管理員服務資源後，瀏覽至 [診斷設定]，然後選取 [add diagnostics settings]。 請遵循這些步驟來開始收集及儲存記錄:
- 提供診斷設定的名稱。
- 選取您想要開始收集記錄的類別。
- 從儲存體帳戶、事件中樞或記錄分析工作區選擇收集目的地。
現在，您可以瀏覽至您在診斷設定中指定之目的地，以存取記錄。 在用於農業的資料管理員作業完成 10 分鐘 (最多) 後，您就可以存取記錄資訊。 在大部分情況下，不會這麼久。
解讀記錄
每個記錄會遵循資料表中所列的結構描述。 資料表包含欄位名稱和描述:
| 欄位名稱 | 描述 |
|---|---|
| time | 日期和時間 (UTC)。 |
| resourceId | Azure Resource Manager 資源識別碼。 針對記錄，這是用於農業的資料管理員資源識別碼。 |
| operationName | 如所述作業的名稱。 |
| operationVersion | 用戶端所要求的 REST API 版本。 |
| category | 結果的類型。 |
| resultType | REST API 要求的結果 (成功或失敗)。 |
| resultSignature | HTTP 狀態。 |
| resultDescription | 結果的額外描述 (若有提供)。 |
| durationMs | 服務 REST API 要求時所花費的時間，以毫秒為單位。 |
| callerIpAddress | 提出要求用戶端的 IP 位址。 |
| level | 事件的嚴重性層級 (資訊、警告、錯誤或危急)。 |
| correlationId | 可用來將記錄相互關聯的選擇性 GUID。 |
| identity | 權杖中的身分識別，會在 REST API 要求中提供。 這通常是物件識別碼和應用程式識別碼，或兩者之一。 |
| 位置 | 發出事件之資源的區域，例如「美國東部」 |
| properties | 對於每個 operationName，這包含: requestUri (API 要求的 URI)，partyId (與要求相關聯的 partyId，只要適用)，dataPlaneResourceId (可唯一識別要求中的資料平面資源的識別碼) 和 requestBody (包含與 operationName 相關聯之 API 呼叫的要求本文，適用於 ApplicationAuditLogs 以外的所有類別)。 除了在 jobProcessesLogs 類別之前提及的一般類別以外，還有: 1。 此清單是跨 operationNames 的欄位： jobRunType (可以是 oneTime 或定期)、jobId (作業的識別碼)、initiatedBy (指出作業是由使用者或服務觸發)。 2. 此清單是失敗的 farmOperation 相關作業的欄位： farmOperationEntityId (farmOperation 作業無法建立之實體的識別碼)、farmOperationEntityType (無法建立的實體類型)、errorCode (作業失敗的程式碼)、errorMessage (失敗的描述)、internalErrorCode (提供者提供的失敗程式碼)、internalErrorMessage (提供者提供的失敗描述)、providerId (提供者的識別碼)。 |
用於農業的資料管理員的 categories 欄位可以具有下表所列的值:
類別資料表
| category | 描述 |
|---|---|
| FarmManagementLogs | 用於合作對象、伺服器陣列、欄位、季節性欄位、作物、CropVariety、季節、附屬物、處方地圖、處方、管理區域、區域、植物組織分析和營養分析的 CRUD 作業記錄。 |
| FarmOperationsLogs | 用於 FarmOperations 資料擷取作業、ApplicationData、PlantingData、HarvestingData、TillageData 的 CRUD 作業記錄 |
| SatelliteLogs | 適用於衛星資料擷取作業之建立和取得作業的記錄 |
| WeatherLogs | 適用於天氣資料擷取作業之建立、刪除和取得作業的記錄 |
| ProviderAuthLogs | 建立、更新、刪除、串聯刪除、取得和取得 OAuth 提供者的所有記錄。 它也有適用於 oauth 權杖的取得、取得所有、串聯刪除的記錄。 |
| JobProcessedLogs | 用於指出作業成功或失敗以及失敗原因的記錄。 除了資源串聯刪除作業、資料擷取作業的記錄之外，它也包含伺服器陣列作業和事件處理作業的記錄。 |
| ModelInferenceLogs | 適用於生質模型作業之建立和取得作業的記錄。 |
| InsightLogs | 適用於深入解析之取得和取得所有作業的記錄。 |
| ApplicationAuditLogs | 適用於特殊權限動作的記錄，例如資料平面資源建立、更新、刪除和訂用帳戶管理作業。 完整清單位於下列作業名稱資料表中。 |
operationName 欄位值為 Microsoft.AgFoodPlatform/resource-name/read 或 write 或 delete 或 action 格式。
- 作業名稱中的
/write尾碼對應至建立或更新資源名稱 /read作業名稱中的尾碼對應至 GET/ LIST /GET ALL API 呼叫或資源名稱串聯刪除作業的 GET 狀態/delete尾碼對應至資源名稱的刪除/action尾碼對應至資源名稱的 POST 方法呼叫/processed尾碼對應至作業的完成 (PUT 方法呼叫)。 這表示作業的狀態 (成功或失敗)。/failures尾碼對應至伺服器陣列作業的失敗 (PUT 方法呼叫)，並包含失敗原因的描述。
作業的命名法如下:
- 針對資料擷取作業: Microsoft.AgFoodPlatform/ingestionJobs/<'resource-name'>DataingestionJobs/write
- 針對刪除作業: Microsoft.AgFoodPlatform/deletionJobs/<'resource-name'>cascadeDeleteJobs/write
下表列出作為索引標籤之類別的 operationName 值和相對應的 REST API 命令:
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/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/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
其他類別中存在的寫入和刪除記錄也存在於此類別中。 此類別中的記錄與其他相同 API 呼叫類別之間的差異在於，ApplicationAuditLogs 不會記錄要求主體，而在其他類別中則會填入要求主體。 使用 correlation-id 讓兩個不同類別的記錄產生關聯，以取得更多詳細資料。 以下列出不屬於其餘類別的一些控制平面作業。
注意
若要進行控制平面呼叫，您需要 ADMA 資源範圍的擁有者存取權。
| operationName |
|---|
| 建立用於農業的資料管理員資源 |
| 更新用於農業的資料管理員資源 |
| 刪除用於農業的資料管理員資源 |
| 建立訂閱 |
| 更新訂閱 |
| 資料平面驗證 |
在記錄分析工作區中查詢資源記錄
所有資源記錄的 categories 都會對應為記錄分析中的資料表。 若要存取每個類別的記錄，您必須建立診斷設定，將資料傳送至記錄分析工作區。 在此工作區中，您可以查詢任何列出的資料表，以取得相關的記錄。
記錄分析中的資料表清單及其對應至資源記錄中的類別
| 記錄分析中的資料表名稱 | 資源記錄中的類別 | 描述 |
|---|---|---|
| AgriFoodFarmManagementLogs | FarmManagementLogs | 用於合作對象、伺服器陣列、欄位、季節性欄位、作物、CropVariety、季節、附屬物、處方地圖、處方、管理區域、區域、植物組織分析和營養分析的 CRUD 作業記錄。 |
| AgriFoodFarmOperationsLogs | FarmOperationsLogs | 用於 FarmOperations 資料擷取作業、ApplicationData、PlantingData、HarvestingData、TillageData 的 CRUD 作業記錄。 |
| AgriFoodSatelliteLogs | SatelliteLogs | 適用於衛星資料擷取作業之建立和取得作業的記錄。 |
| AgriFoodWeatherLogs | WeatherLogs | 適用於天氣資料擷取作業之建立、刪除和取得作業的記錄。 |
| AgriFoodProviderAuthLogs | ProviderAuthLogs | 適用於 Oauth 提供者的建立、更新、刪除、串聯刪除、取得和取得全部的記錄。 它也有適用於 oauth 權杖的取得、取得所有、串聯刪除的記錄。 |
| AgriFoodInsightLogs | InsightLogs | 適用於深入解析之取得和取得所有作業的記錄。 |
| AgriFoodModelInferenceLogs | ModelInferenceLogs | 適用於生質模型作業之建立和取得作業的記錄。 |
| AgriFoodJobProcessedLogs | JobProcessedLogs | 用於指出作業成功或失敗以及失敗原因的記錄。 除了資源串聯刪除作業和資料擷取作業的記錄之外。 它也包含伺服器陣列作業和事件處理作業的記錄。 |
| AgriFoodApplicationAuditLogs | ApplicationAuditLogs | 適用於特殊權限動作的記錄，例如資料平面資源建立、更新、刪除和訂用帳戶管理作業。 |
記錄分析資料表中的資料行清單
| 欄位名稱 | 描述 |
|---|---|
| Time | 日期和時間 (UTC)。 |
| ResourceId | 用於農業的資料管理員的 Azure Resource Manager 資源識別碼。 |
| OperationName | 前一份表格所述作業的名稱。 |
| OperationVersion | 用戶端所要求的 REST API 版本。 |
| 類別 | 在農業資料管理員記錄中的類別詳細資料，可為類別表中所列的任何值。 |
| ResultType | REST API 要求的結果 (成功或失敗)。 |
| ResultSignature | HTTP 狀態。 |
| ResultDescription | 結果的詳細描述 (若有提供)。 |
| DurationMs | 服務 REST API 要求時所花費的時間，以毫秒為單位。 |
| CallerIpAddress | 提出要求用戶端的 IP 位址。 |
| 等級 | 事件的嚴重性層級 (資訊、警告、錯誤或危急)。 |
| CorrelationId | 可用來將記錄相互關聯的選擇性 GUID。 |
| ApplicationId | 指出呼叫者身分識別的應用程式識別碼。 |
| ObjectId | 指出呼叫者身分識別的物件識別碼。 |
| ClientTenantId | 呼叫者租用戶的識別碼。 |
| SubscriptionId | 呼叫者使用的訂用帳戶識別碼。 |
| 地點 | 發出事件之資源的區域，例如「美國東部」 |
| JobRunType | 僅適用於 AgriFoodJobProcessesLogs 資料表，表示作業執行的類型。 值可以是定期或一次。 |
| JobId | 適用於AgriFoodJobProcessesLogs、AgriFoodSatelliteLogs、AgriFoodWeatherLogs和AgriFoodModelInferenceLogs，表示作業的識別碼。 |
| InitiatedBy | 僅適用於 AgriFoodJobProcessesLogs 資料表。 指出作業是由使用者或服務起始。 |
| partyId | 與作業相關聯的合作對象識別碼。 |
| 屬性 | 僅適用於AgriFoodJobProcessesLogs資料表，其中包含: farmOperationEntityId (farmOperation 作業無法建立的實體識別碼)、farmOperationEntityType(無法建立的實體類型、可以是 ApplicationData、PeriodicJob 等)、errorCode(用於農業的資料管理員的作業失敗代碼)、errorMessage(用於農業的資料管理員的失敗描述)、internalErrorCode(提供者提供的作業失敗程式碼)、internalErrorMessage(提供者提供的失敗描述)、providerId(如 JOHN-DEERE 等提供者的識別碼)。 |
您可以藉由建立記錄分析工作區來查詢這些資料表。 查詢語言的參考在這裡。
記錄分析工作區中的範例查詢清單
| 查詢名稱 | 描述 |
|---|---|
| 合作對象的伺服器陣列管理作業狀態 | 擷取每個合作對象在 FarmManagementLogs 類別內的作業成功和失敗的計數。 |
| 合作對象的作業執行統計資料 | 提供每個合作對象在 JobProcessedLogs 類別內的所有作業成功和失敗的計數。 |
| 失敗的授權 | 識別無法存取資源的使用者清單，及其失敗原因。 |
| 合作對象的所有作業狀態 | 合作對象跨類別的失敗和成功彙總。 |
| 根據執行作業，前 100 個合作對象的使用方式趨勢 | 根據跨類別收到的點閱次數，擷取前 100 個合作對象的清單。 您可以編輯此查詢，以追蹤特定合作對象的使用方式趨勢。 |
上述所有查詢都可做為基礎查詢，以在記錄分析工作區中形成自訂查詢。 您也可以在 Microsoft Azure 入口網站上用於農業的 Azure 資料管理員資源的 [Logs] 索引標籤中存取此查詢清單。
下一步
了解如何設定私人連結。