Registro em logs do Gerenciador de Dados do Azure para Agricultura
Após criar uma instância de recurso do Gerenciador de Dados para Agricultura, você pode monitorar como e quando seus recursos são acessados e por quem. Você também pode depurar os motivos de falha para solicitações de plano de dados. Para fazer isso, você precisa habilitar o registro em logs no Gerenciador de Dados do Azure para Agricultura. Você pode então salvar as informações de log em um destino, como uma conta de armazenamento, um hub de eventos ou um workspace do Log Analytics, que você fornecer.
Este artigo vai te mostrar como configurar o registro em log no Gerenciador de Dados do Azure para Agricultura.
Habilitar a coleta de logs
Depois de criar um recurso do Gerenciador de Dados para Agricultura, vá até as configurações de diagnóstico e selecione add diagnostics settings. Siga estas etapas para começar a coletar e armazenar logs:
- Forneça um nome para a configuração de diagnóstico.
- Selecione as categorias para as quais deseja iniciar a coleta de logs.
- Escolha o destino para a coleta na conta de armazenamento, hub de eventos ou workspace do Log Analytics.
Agora você pode acessar o destino que especificou na configuração de diagnóstico para acessar os logs. Você poderá acessar suas informações de registro em log em até 10 minuto (na maioria das vezes) as após a operação do Gerenciador de Dados para Agricultura. Na maioria dos casos, esse tempo é menor.
Interpretar seus logs
Cada log segue o esquema listado na tabela. A tabela contém os nomes dos campos e suas descrições:
| Nome do campo | Descrição |
|---|---|
| time | Data e hora em UTC. |
| resourceId | ID do Recurso do Azure Resource Manager. Para logs, esta é a ID de recurso do Gerenciador de Dados para Agricultura. |
| operationName | Nome da operação, como documentado. |
| operationVersion | Versão da API REST solicitada pelo cliente. |
| category | Tipo de resultado. |
| resultType | Resultado da solicitação à API REST (sucesso ou falha). |
| resultSignature | Código de status HTTP. |
| resultDescription | Descrição adicional sobre o resultado, quando disponível. |
| durationMs | Tempo necessário para atender à solicitação da API REST, em milissegundos. |
| callerIpAddress | Endereço IP do cliente que fez o a solicitação. |
| level | O nível de gravidade do evento (Informativo, Aviso, Erro ou Crítico). |
| correlationId | Um GUID opcional que pode ser usado para correlacionar logs. |
| identity | Identidade do token que foi apresentado na solicitação à API REST. Isso geralmente é uma ID de objeto e uma ID de aplicativo ou uma das duas. |
| local | A região do recurso que emite o evento, como "Leste dos EUA" |
| properties | Para cada operationName, isso contém: requestUri (URI da solicitação da API), partyId (partyId associado à solicitação, quando aplicável), dataPlaneResourceId (ID que identifica exclusivamente o recurso do plano de dados na solicitação) e requestBody (contém o corpo da solicitação para a chamada à API associada ao operationName para todas as categorias, exceto ApplicationAuditLogs). Além dos comuns mencionados antes, a categoria jobProcessesLogs inclui: 1. Essa lista contém campos em operationNames: jobRunType (pode ser oneTime ou periodic), jobId (ID do trabalho) initiatedBy (indica se um trabalho foi disparado por um usuário ou pelo serviço). 2. Esta lista contém campos para trabalhos relacionados a farmOperation que falharam: farmOperationEntityId (ID da entidade que falhou ao ser criada pelo trabalho farmOperation), farmOperationEntityType (tipo da entidade que falhou ao ser criada), errorCode (código da falha do trabalho), errorMessage (descrição da falha), internalErrorCode (código de falha fornecido pelo provedor), internalErrorMessage (descrição da falha fornecida pelo provedor), providerId (ID do provedor). |
O campo categories do Gerenciador de Dados para Agricultura pode ter valores listados na tabela a seguir:
Tabela de categorias
| category | Descrição |
|---|---|
| FarmManagementLogs | Logs de operações CRUD relacionadas à parte, fazenda, campos, campos sazonal, cultura, variedade de cultura, estação, anexo, mapas de prescrição, prescrições, zonas de gerenciamento, zonas, análise de tecido vegetal e análises de nutrientes. |
| FarmOperationsLogs | Logs de operações CRUD do trabalho de ingestão de dados de FarmOperations, ApplicationData, PlantingData, HarvestingData e TillageData |
| SatelliteLogs | Logs de operações de criação e obtenção do trabalho de ingestão de dados de satélite |
| WeatherLogs | Logs de operações de criação, exclusão e obtenção do trabalho de ingestão de dados meteorológicos |
| ProviderAuthLogs | Logs de operações de criação, atualização, exclusão, exclusão em cascata, obtenção e obtenção de todos os provedores OAuth. Inclui também logs para obtenção, obtenção de tudo e exclusão em cascata de tokens OAuth. |
| JobProcessedLogs | Logs que indicam sucesso ou falha e o motivo da falha nos trabalhos. Além dos logs para trabalhos de exclusão em cascata de recursos e trabalhos de ingestão de dados, também contém logs para operações agrícolas e trabalhos de manipulação de eventos. |
| ModelInferenceLogs | Logs para operações de criação e obtenção do trabalho de modelo de biomassa. |
| InsightLogs | Logs de operações de obtenção e obtenção de tudo para insights. |
| ApplicationAuditLogs | Logs de ações privilegiadas, como operações de criação, atualização, exclusão de recursos do plano de dados e operações de gerenciamento de assinatura. A lista completa está na tabela de nomes de operações abaixo. |
Os valores do campo operationName estão no formato Microsoft.AgFoodPlatform/resource-name/read ou write ou delete ou action.
- O sufixo
/writeno nome da operação corresponde a uma criação ou atualização do resource-name - O sufixo
/readno nome da operação corresponde a chamadas à API GET/LIST/GET ALL ou status GET para um trabalho de exclusão em cascata do resource-name - O sufixo
/deletecorresponde à exclusão do resource-name - O sufixo
/actioncorresponde a chamadas de método POST para um resource-name - O sufixo
/processedcorresponde à conclusão de um trabalho (uma chamada de método PUT). Isso indica o status do trabalho (sucesso ou falha). - O sufixo
/failurescorresponde à falha de um trabalho de operação agrícola (uma chamada de método PUT) e contém uma descrição sobre o motivo da falha.
A nomenclatura para Trabalhos é a seguinte:
- Para trabalhos de ingestão de dados: Microsoft.AgFoodPlatform/ingestionJobs/<'resource-name'>DataingestionJobs/write
- Para trabalhos de exclusão: Microsoft.AgFoodPlatform/deletionJobs/<'resource-name'>cascadeDeleteJobs/write
A tabela a seguir lista os valores de operationName e os comandos da API REST para um categoria correspondente como uma guia:
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
Os logs de gravação e exclusão presentes em outras categorias também estão presentes nessa categoria. A diferença entre os logs nessa categoria e em outras categorias para a mesma chamada à API é que, ApplicationAuditLogs não registra o corpo da solicitação, enquanto nas outras categorias o corpo da solicitação é preenchido. Usa a ID de correlação para relacionar logs de duas categorias diferentes e obter mais detalhes. Algumas das operações do painel de controle que não fazem parte do restante das categorias estão listadas abaixo.
Observação
Você precisa do acesso de proprietário ao escopo de recurso do ADMA para fazer chamadas de painel de controle.
| operationName |
|---|
| Criar Recurso do Gerenciador de Dados para Agricultura |
| Atualizar Recurso do Gerenciador de Dados para Agricultura |
| Excluir Recurso do Gerenciador de Dados para Agricultura |
| Criar Assinatura |
| Atualizar Assinatura |
| Autenticação do Plano de Dados |
Consultar logs de recursos em um workspace do Log Analytics
Todas as categories de logs de recursos são mapeadas como uma tabela na análise de logs. Para acessar os logs de cada categoria, você precisa criar uma configuração de diagnóstico para enviar dados a um workspace do Log Analytics. Neste workspace, você pode consultar qualquer uma das tabelas listadas para obter os logs relevantes.
Lista de tabelas na análise de logs e seu mapeamento para categorias em logs de recursos
| O nome da tabela na análise de logs | Categorias em logs de recursos | Descrição |
|---|---|---|
| AgriFoodFarmManagementLogs | FarmManagementLogs | Logs de operações CRUD relacionadas à parte, fazenda, campos, campos sazonal, cultura, variedade de cultura, estação, anexo, mapas de prescrição, prescrições, zonas de gerenciamento, zonas, análise de tecido vegetal e análises de nutrientes. |
| AgriFoodFarmOperationsLogs | FarmOperationsLogs | Logs para operações CRUD do trabalho de ingestão de dados de FarmOperations, ApplicationData, PlantingData, HarvestingData e TillageData. |
| AgriFoodSatelliteLogs | SatelliteLogs | Logs de operações de criação e obtenção do trabalho de ingestão de dados de satélite. |
| AgriFoodWeatherLogs | WeatherLogs | Logs de operações de criação, exclusão e obtenção do trabalho de ingestão de dados meteorológicos. |
| AgriFoodProviderAuthLogs | ProviderAuthLogs | Logs de operações de criação, atualização, exclusão, exclusão em cascata, obtenção e obtenção de todos os provedores OAuth. Inclui também logs para obtenção, obtenção de tudo e exclusão em cascata de tokens OAuth. |
| AgriFoodInsightLogs | InsightLogs | Logs de operações de obtenção e obtenção de tudo para insights. |
| AgriFoodModelInferenceLogs | ModelInferenceLogs | Logs para operações de criação e obtenção do trabalho de modelo de biomassa. |
| AgriFoodJobProcessedLogs | JobProcessedLogs | Logs que indicam sucesso ou falha e o motivo da falha nos trabalhos. Além dos logs para trabalhos de exclusão em cascata de recursos e trabalhos de ingestão de dados. Também contém logs para operações agrícolas e trabalhos de manipulação de eventos. |
| AgriFoodApplicationAuditLogs | ApplicationAuditLogs | Logs de ações privilegiadas, como operações de criação, atualização, exclusão de recursos do plano de dados e operações de gerenciamento de assinatura. |
Lista de colunas em tabelas da análise de logs
| Nome do campo | Descrição |
|---|---|
| Hora | Data e hora em UTC. |
| ResourceId | ID do recurso do Azure Resource Manager para logs do Gerenciador de Dados para Agricultura. |
| OperationName | Nome da operação, como documentado na tabela anterior. |
| OperationVersion | Versão da API REST solicitada pelo cliente. |
| Categoria | Detalhes da categoria nos logs do Gerenciador de Dados para Agricultura, podendo ser qualquer valor listado na tabela de categorias. |
| ResultType | Resultado da solicitação à API REST (sucesso ou falha). |
| ResultSignature | Código de status HTTP. |
| ResultDescription | Mais descrição sobre o resultado, quando disponível. |
| DurationMs | Tempo necessário para atender à solicitação da API REST, em milissegundos. |
| CallerIpAddress | Endereço IP do cliente que fez o a solicitação. |
| Nível | O nível de gravidade do evento (informativo, aviso, erro, ou crítico). |
| CorrelationId | Um GUID opcional que pode ser usado para correlacionar logs. |
| ApplicationId | ID do aplicativo que indica a identidade do chamador. |
| ObjectId | ID do objeto que indica a identidade do chamador. |
| ClientTenantId | ID do locatário do chamador. |
| SubscriptionId | ID da assinatura usada pelo chamador. |
| Localidade | A região do recurso que emite o evento, como "Leste dos EUA" |
| JobRunType | Disponível apenas na tabela AgriFoodJobProcessesLogs, indica o tipo da execução do trabalho. O valor pode ser periódico ou único. |
| JobId | Disponível em AgriFoodJobProcessesLogs, AgriFoodSatelliteLogs, AgriFoodWeatherLogs e AgriFoodModelInferenceLogs, indica a ID do trabalho. |
| InitiatedBy | Disponível apenas na tabela AgriFoodJobProcessesLogs. Indica se um trabalho foi iniciado por um usuário ou pelo serviço. |
| partyId | ID da parte associada à operação. |
| Propriedades | Disponível apenas na tabela AgriFoodJobProcessesLogs, contém: farmOperationEntityId (ID da entidade que falhou ao ser criada pelo trabalho farmOperation), farmOperationEntityType (Tipo da entidade que falhou ao ser criada, podendo ser ApplicationData, PeriodicJob, etc.), errorCode (Código da falha do trabalho no Gerenciador de Dados para Agricultura), errorMessage (Descrição da falha no Gerenciador de Dados para Agricultura), internalErrorCode (Código da falha do trabalho fornecido pelo provedor), internalErrorMessage (Descrição da falha fornecida pelo provedor), providerId (ID do provedor, como JOHN-DEERE). |
Cada uma dessas tabelas pode ser consultada criando um workspace do Log Analytics. O artigo de referência para a linguagem da consulta está aqui.
Lista de consultas de exemplo no workspace do Log Analytics
| Nome da consulta | Descrição |
|---|---|
| Status das operações de gerenciamento de fazenda para uma parte | Obtém o número de sucessos e falhas de operações dentro da categoria FarmManagementLogs para cada parte. |
| Estatísticas de execução de trabalhos para uma parte | Fornece o número de sucessos e falhas para todas as operações na categoria JobProcessedLogs para cada parte. |
| Autorização com falha | Identifica uma lista de usuários que falharam ao acessar seu recurso e o motivo para essa falha. |
| Status de todas as operações para uma parte | Agrega falhas e sucessos em categorias para uma parte. |
| Tendências de uso para as 100 principais partes com base nas operações realizadas | Recupera uma lista das 100 principais partes com base no número de acessos recebidos em todas as categorias. Essa consulta pode ser editada para acompanhar a tendência de uso de uma parte específica. |
Todas as consultas listadas acima podem ser usadas como consultas de base para formar consultas personalizadas em um workspace do Log Analytics. Essa lista de consultas também pode ser acessada na guia Logs em seu recurso Gerenciador de Dados para Agricultura no portal do Azure.
Próximas etapas
Aprenda como configurar links privados.