Ведение журнала Azure Data Manager для сельского хозяйства
После создания экземпляра ресурса Data Manager для сельского хозяйства вы можете отслеживать, как и когда доступ к ресурсам осуществляется, и кем. Вы также можете отлаживать причины сбоя запросов плоскости данных. Для этого необходимо включить ведение журнала для Azure Data Manager для сельского хозяйства. Затем вы можете сохранить данные журнала в месте назначения, например учетную запись хранения, концентратор событий или рабочую область log analytics, которую вы предоставляете.
В этой статье приведены инструкции по настройке ведения журнала для Azure Data Manager для сельского хозяйства.
Включение сбора журналов
После создания ресурса службы Data Manager для сельского хозяйства перейдите к диагностика параметрам, а затем выберите add diagnostics settings. Выполните следующие действия, чтобы начать сбор и хранение журналов:
- Укажите имя для параметра диагностики.
- Выберите категории, для которых нужно начать сбор журналов.
- Выберите место для сбора из учетной записи хранения, концентратора событий или рабочей области Log Analytics.
Теперь вы можете перейти к месту назначения, указанному в параметре диагностики для доступа к журналам. Вы можете получить доступ к данным ведения журнала в течение 10 минут (не более чем) после операции Диспетчера данных для сельского хозяйства. В большинстве случаев это быстрее.
Интерпретация журналов
Каждый журнал следует схеме, указанной в таблице. Таблица содержит имена полей и описания:
| Имя поля | Description |
|---|---|
| time | Дата и время (в формате UTC). |
| resourceId | Идентификатор ресурса Azure Resource Manager. Для журналов это идентификатор ресурса Data 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 (URI запроса API), partyId(partyId, связанный с запросом, где угодно),dataPlaneResourceId (идентификатор, который однозначно идентифицирует ресурс плоскости данных в запросе) и requestBody (содержит текст запроса для вызова API, связанного со operationName всеми категориями, кроме ApplicationAuditLogs). Кроме упоминаемого ранее jobProcessesLogs категории, отличается от общей категории: 1. Этот список содержит поля в операцияхNames: jobRunType (может быть одним или периодическим), (идентификатор задания) jobId initiatedBy (указывает, активируется ли задание пользователем или службой). 2. Этот список полей для неудачных заданий farmOperation: farmOperationEntityId (идентификатор сущности, которая не была создана заданием farmOperation), (тип сущности, которая не удалось создать), farmOperationEntityTypeerrorCode(код errorMessageсбоя задания), (описание сбоя), internalErrorCode(код сбоя, предоставленный поставщиком), (описание сбоя, предоставленного поставщиком), (описание сбоя, предоставленного поставщиком), internalErrorMessageproviderId(идентификатор поставщика). |
Поле categories для диспетчера данных для сельского хозяйства может иметь значения, перечисленные в следующей таблице:
Таблица категорий
| Категория | Description |
|---|---|
| FarmManagementLogs | Журналы операций CRUD для партии, фермы, поля, сезонного поля, обрезки, обрезки, сезона, вложения, рецепты, рецепты, зоны управления, зоны, анализ ткани растений и анализ питательных веществ. |
| FarmOperationsLogs | Журналы операций CRUD для задания приема данных FarmOperations, ApplicationData, PlantingData, HarvestingData, TillageData |
| SatelliteLogs | Журналы для создания и получения операций для задания приема спутниковых данных |
| WeatherLogs | Журналы для создания, удаления и получения операций для задания приема данных погоды |
| ProviderAuthLogs | Журналы для создания, обновления, удаления, каскадного удаления, получения и получения всех для поставщиков Oauth. Он также содержит журналы для получения, получения всех, каскадного удаления для маркеров oauth. |
| JobProcessedLogs | Журналы для указания успеха или сбоя и причины сбоя заданий. Помимо журналов для заданий каскадного удаления ресурсов, заданий приема данных также содержатся журналы для операций фермы и заданий обработки событий. |
| ModelInferenceLogs | Журналы для создания и получения операций для задания модели биомассы. |
| InsightLogs | Журналы для получения и получения всех операций для аналитики. |
| ApplicationAuditLogs | Журналы для привилегированных действий, таких как создание, обновление, удаление и операции управления подписками. Полный список находится в таблице имен операции ниже. |
Значения operationName полей находятся в формате Microsoft.AgFoodPlatform/resource-name/read или write или delete или action format.
/writeсуффикс в имени операции соответствует созданию или обновлению имени ресурса/readсуффикс в имени операции соответствует вызову GET/LIST /GET ALL API или состоянию GET для каскадного задания удаления для имени ресурса/deleteсуффикс соответствует удалению имени ресурса/actionсуффикс соответствует вызовам метода POST для имени ресурса/processedсуффикс соответствует завершению задания (вызов метода PUT). Это означает состояние задания (успешно или неудачно)./failuresсуффикс соответствует сбою задания операции фермы (вызов метода PUT) и содержит описание причины сбоя.
Nomenclature for Jobs имеет следующий тип:
- Для заданий приема данных: 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/рецепты/write |
| Microsoft.AgFoodPlatform/рецепты/чтение |
| Microsoft.AgFoodPlatform/рецепты/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/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/bioModelJobs/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 не регистрирует текст запроса, а в других категориях заполнен текст запроса. Используйте идентификатор корреляции для связи журналов двух разных категорий, чтобы получить дополнительные сведения. Ниже перечислены некоторые операции плоскости управления, которые не являются частью остальных категорий.
Примечание.
Для вызова плоскости управления требуется доступ владельца к области ресурсов ADMA.
| operationName |
|---|
| Создание ресурса Data Manager для сельского хозяйства |
| Обновление ресурса Data Manager для сельского хозяйства |
| Удаление ресурса Data Manager для сельского хозяйства |
| Создавать подписку |
| Обновлять подписку |
| Проверка подлинности уровня данных |
Запрос журналов ресурсов в рабочей области Log Analytics
categories Все журналы ресурсов сопоставляются как таблица в log analytics. Чтобы получить доступ к журналам для каждой категории, необходимо создать параметр диагностики для отправки данных в рабочую область Log Analytics. В этой рабочей области можно запросить любую из таблиц, перечисленных для получения соответствующих журналов.
Список таблиц в log analytics и их сопоставление с категориями в журналах ресурсов
| Имя таблицы в log analytics | Категории в журналах ресурсов | Description |
|---|---|---|
| AgriFoodFarmManagementLogs | FarmManagementLogs | Журналы операций CRUD для партии, фермы, поля, сезонного поля, обрезки, обрезки, сезона, вложения, рецепты, рецепты, зоны управления, зоны, анализ ткани растений и анализ питательных веществ. |
| AgriFoodFarmOperationsLogs | FarmOperationsLogs | Журналы операций CRUD для задания приема данных FarmOperations, ApplicationData, PlantingData, HarvestingData, TillageData. |
| AgriFoodSatelliteLogs | SatelliteLogs | Журналы для создания и получения операций для задания приема спутниковых данных. |
| AgriFoodWeatherLogs | WeatherLogs | Журналы для создания, удаления и получения операций для задания приема данных погоды. |
| AgriFoodProviderAuthLogs | ProviderAuthLogs | Журналы для создания, обновления, удаления, каскадного удаления, получения и получения всех для поставщиков oauth. Он также содержит журналы для получения, получения всех, каскадного удаления для маркеров oauth. |
| AgriFoodInsightLogs | InsightLogs | Журналы для получения и получения всех операций для аналитики. |
| AgriFoodModelInferenceLogs | ModelInferenceLogs | Журналы для создания и получения операций для задания модели биомассы. |
| AgriFoodJobProcessedLogs | JobProcessedLogs | Журналы для указания успеха или сбоя и причины сбоя заданий. Помимо журналов для заданий каскадного удаления ресурсов, заданий приема данных. Он также содержит журналы для операций фермы и заданий обработки событий. |
| AgriFoodApplicationAuditLogs | ApplicationAuditLogs | Журналы для привилегированных действий, таких как создание, обновление, удаление и операции управления подписками. |
Список столбцов в таблицах log analytics
| Имя поля | Description |
|---|---|
| Time | Дата и время (в формате UTC). |
| ResourceId | Идентификатор ресурса Azure Resource Manager для журналов data Manager для сельского хозяйства. |
| OperationName | Имя операции, как описано в предыдущей таблице. |
| OperationVersion | Запрошенная клиентом версия REST API. |
| Категория | Сведения о категориях в журналах Data Manager для сельского хозяйства могут быть любым значением, как указано в таблице категорий. |
| ResultType | Результат запроса REST API (успешное выполнение или сбой). |
| ResultSignature | Состояние HTTP. |
| ResultDescription | Дополнительные сведения о результатах, когда они доступны. |
| Длительность | Время обслуживания запроса REST API в миллисекундах. |
| CallerIpAddress | IP-адрес клиента, выполнившего запрос. |
| Уровень | Уровень серьезности события (информационное, предупреждение, ошибка или критически важный). |
| CorrelationId | Необязательный GUID, который можно использовать для сопоставления журналов. |
| ApplicationId | Идентификатор приложения, указывающий удостоверение вызывающего объекта. |
| ObjectId | Идентификатор объекта, указывающий удостоверение вызывающего объекта. |
| ClientTenantId | Идентификатор клиента вызывающего объекта. |
| SubscriptionId | Идентификатор подписки, используемой вызывающим абонентом. |
| Местонахождение | Регион ресурса, создающего событие, например "Восточная часть США" |
| JobRunType | Доступно только в AgriFoodJobProcessesLogs таблице, указывает тип выполнения задания. Значение может быть периодическим или один раз. |
| JobId | Доступно вAgriFoodJobProcessesLogs, AgriFoodSatelliteLogsAgriFoodWeatherLogsи AgriFoodModelInferenceLogs, указывает идентификатор задания. |
| ИнициированоBy | Доступно только в AgriFoodJobProcessesLogs таблице. Указывает, инициируется ли задание пользователем или службой. |
| partyId | Идентификатор стороны, связанной с операцией. |
| Свойства | Доступно только вAgriFoodJobProcessesLogs таблице: farmOperationEntityId (идентификатор сущности, которая не была создана заданием farmOperation), farmOperationEntityType(тип сущности, которую не удалось создать, может быть ApplicationData, PeriodicJob и т. д.), errorCode(Код сбоя задания в data Manager для сельского хозяйства),(Описание сбоя в конце диспетчера данных для сельского хозяйства)errorMessage(Код сбоя задания, предоставленного поставщиком),internalErrorCode internalErrorMessage(Описание сбоя, предоставленного поставщиком),providerId (идентификатор поставщика, например JOHN-DEERE). |
Каждую из этих таблиц можно запросить, создав рабочую область Log Analytics. Здесь приведена ссылка на язык запросов.
Список примеров запросов в рабочей области Log Analytics
| Имя запроса | Description |
|---|---|
| Состояние операций управления фермой для стороны | Извлекает количество успешных и неудачных операций в категории для каждой FarmManagementLogs стороны. |
| Статистика выполнения задания для участника | Предоставляет количество успешных и неудачных операций для всех операций в категории для каждой JobProcessedLogs стороны. |
| Сбой авторизации | Определяет список пользователей, которые не смогли получить доступ к ресурсу и причину этого сбоя. |
| Состояние всех операций для стороны | Агрегирует неудачи и успехи между категориями для партии. |
| Тенденции использования для лучших 100 сторон на основе выполненных операций | Извлекает список лучших 100 сторон на основе количества попаданий, полученных по категориям. Этот запрос можно изменить, чтобы отслеживать тенденцию использования для конкретной стороны. |
Все приведенные выше запросы можно использовать в качестве базовых запросов для формирования пользовательских запросов в рабочей области log analytics. Этот список запросов также можно получить на вкладке Logs в ресурсе Azure Data Manager для сельского хозяйства портал Azure.
Следующие шаги
Узнайте, как настроить приватные ссылки.