Registo do Azure Data Manager para Agricultura
Depois de 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 motivos de falha para solicitações de plano de dados. Para fazer isso, você precisa habilitar o log para o Azure Data Manager for Agriculture. Em seguida, você pode salvar informações de log em um destino, como uma conta de armazenamento, hub de eventos ou um espaço de trabalho de análise de log, que você fornece.
Este artigo fornece as etapas para configurar o log para o Azure Data Manager for Agriculture.
Habilitar a coleta de logs
Depois de criar um recurso de serviço do Gerenciador de Dados para Agricultura, navegue 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 definição de diagnóstico.
- Selecione as categorias para as quais você deseja começar a coletar logs.
- Escolha o destino da coleta na conta de armazenamento, no hub de eventos ou em um espaço de trabalho de análise de log.
Agora você pode navegar até o destino especificado na configuração de diagnóstico para acessar os logs. Você pode acessar suas informações de registro 10 minutos (no máximo) após a operação do Data Manager for Agriculture. Na maioria dos casos, é mais rápido.
Interprete seus logs
Cada log segue o esquema listado na tabela. A tabela contém os nomes e descrições dos campos:
| Nome do campo | Description |
|---|---|
| Hora | Data e hora em UTC. |
| resourceId | ID de recurso do Azure Resource Manager. Para logs, este é o ID de recurso do Gerenciador de Dados para Agricultura. |
| operationName | Nome da operação, conforme documentado. |
| operationVersion | Versão da API REST solicitada pelo cliente. |
| category | Tipo de resultado. |
| resultType | Resultado da solicitação da API REST (sucesso ou falha). |
| resultAssinatura | Estado de HTTP. |
| descrição do resultado | Descrição extra sobre o resultado, quando disponível. |
| duraçãoSra. | Tempo necessário para o processamento do pedido de API REST, em milissegundos. |
| callerIpAddress | Endereço IP do cliente que fez o pedido. |
| 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. |
| identidade | Identidade do token que foi apresentado na solicitação da API REST. Isso geralmente é um ID de objeto e um ID de aplicativo ou qualquer um dos dois. |
| localização | A região do recurso emissor do evento, como "Leste dos EUA" |
| propriedades | Para cada operationName um, isso contém: requestUri (URI da solicitação de API), partyId(partyId associado à solicitação, sempre que aplicável),dataPlaneResourceId (ID que identifica exclusivamente o recurso de plano de dados na solicitação) e requestBody (contém o corpo da solicitação para a chamada de API associada ao operationName para todas as categorias diferentes de ApplicationAuditLogs). Além do comum mencionado anteriormente jobProcessesLogs , a categoria tem: 1. Esta lista é de campos entre operationNames: jobRunType (pode ser oneTime ou periodic), jobId (ID do trabalho), initiatedBy (indica se um trabalho foi acionado por um usuário ou pelo serviço). 2. Esta lista é de campos para trabalhos relacionados a farmOperation com falha: farmOperationEntityId (ID da entidade que não pôde ser criada pelo trabalho farmOperation), farmOperationEntityType(tipo da entidade que não pôde ser criada), errorCode(código para falha de 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 categories campo do Gerenciador de Dados para Agricultura pode ter valores listados na tabela a seguir:
Tabela de categorias
| category | Description |
|---|---|
| FarmManagementLogs | Logs para operações CRUD para festa, fazenda, campo, campo sazonal, colheita, colheita, safra, estação, anexo, mapas de prescrição, prescrições, zonas de manejo, zonas, análise de tecido vegetal e análises de nutrientes. |
| FarmOperationsLogs | Logs para operações CRUD para FarmOperations trabalho de ingestão de dados, ApplicationData, PlantingData, HarvestingData, TillageData |
| SatelliteLogs | Logs para criar e obter operações para o trabalho de ingestão de dados de satélite |
| Registos meteorológicos | Logs para criar, excluir e obter operações para o trabalho de ingestão de dados meteorológicos |
| ProviderAuthLogs | Logs para criar, atualizar, excluir, excluir em cascata, obter e obter tudo para provedores Oauth. Ele também tem logs para obter, obter tudo, exclusão em cascata para tokens oauth. |
| JobProcessedLogs | Logs para indicar sucesso ou falha e motivo de falha para trabalhos. Além de logs para trabalhos de exclusão em cascata de recursos, trabalhos de ingestão de dados, ele também contém logs para operações de farm e trabalhos de manipulação de eventos. |
| ModelInferenceLogs | Logs para criar e obter operações para o trabalho de modelo de biomassa. |
| InsightLogs | Logs para obter e obter todas as operações para insights. |
| ApplicationAuditLogs | Logs para ações privilegiadas, como operações de criação, atualização, exclusão e gerenciamento de assinatura de recursos do plano de dados. A lista completa está na tabela de nomes da operação abaixo. |
Os operationName valores de campo estão em Microsoft.AgFoodPlatform/resource-name/read ou write ou delete ou formato de ação .
/writesufixo no nome da operação corresponde a um criar ou atualizar o nome do recurso/readsufixo no nome da operação corresponde a uma chamada GET/ LIST /GET ALL API ou status GET para um trabalho de exclusão em cascata para o nome do recurso/deletesufixo corresponde à exclusão do nome do recurso/actionsufixo corresponde a chamadas de método POST para um nome de recurso/processedsufixo corresponde à conclusão de um trabalho (uma chamada de método PUT). Isso indica o status do trabalho (sucesso ou fracasso)./failureso sufixo corresponde à falha de um trabalho de operação do farm (uma chamada do método PUT) e contém descrição sobre o motivo da falha.
A nomenclatura para Jobs é 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 operationName e os comandos correspondentes da API REST para uma categoria como uma guia:
FarmManagementLogs
| operationName |
|---|
| Microsoft.AgFoodPlatform/agricultores/escrever |
| Microsoft.AgFoodPlatform/agricultores/ler |
| Microsoft.AgFoodPlatform/deletionJobs/farmersCascadeDeleteJobs/write |
| Microsoft.AgFoodPlatform/farms/write |
| Microsoft.AgFoodPlatform/farms/leitura |
| Microsoft.AgFoodPlatform/farms/excluir |
| Microsoft.AgFoodPlatform/deletionJobs/farmsCascadeDeleteJobs/write |
| Microsoft.AgFoodPlatform/campo/gravação |
| Microsoft.AgFoodPlatform/campo/leitura |
| Microsoft.AgFoodPlatform/campo/excluir |
| Microsoft.AgFoodPlatform/deletionJobs/fieldsCascadeDeleteJobs/write |
| Microsoft.AgFoodPlatform/sazonalField/write |
| Microsoft.AgFoodPlatform/seasonalField/read |
| Microsoft.AgFoodPlatform/sazonalField/excluir |
| Microsoft.AgFoodPlatform/deletionJobs/seasonalFieldsCascadeDeleteJobs/write |
| Microsoft.AgFoodPlatform/limites/gravação |
| Microsoft.AgFoodPlatform/boundaries/read |
| Microsoft.AgFoodPlatform/limites/excluir |
| Microsoft.AgFoodPlatform/limites/ação |
| Microsoft.AgFoodPlatform/deletionJobs/fieldsCascadeDeleteJobs/write |
| Microsoft.AgFoodPlatform/colheitas/gravação |
| Microsoft.AgFoodPlatform/crops/read |
| Microsoft.AgFoodPlatform/colheitas/excluir |
| Microsoft.AgFoodPlatform/cropVarieties/write |
| Microsoft.AgFoodPlatform/cropVarieties/read |
| Microsoft.AgFoodPlatform/cropVarieties/excluir |
| Microsoft.AgFoodPlatform/temporadas/escrever |
| Microsoft.AgFoodPlatform/seasons/read |
| Microsoft.AgFoodPlatform/temporadas/excluir |
| Microsoft.AgFoodPlatform/anexos/gravação |
| Microsoft.AgFoodPlatform/anexos/leitura |
| Microsoft.AgFoodPlatform/anexos/excluir |
| Microsoft.AgFoodPlatform/prescrições/gravação |
| Microsoft.AgFoodPlatform/prescrições/leitura |
| Microsoft.AgFoodPlatform/prescrições/excluir |
| Microsoft.AgFoodPlatform/deletionJobs/prescriptionsCascadeDeleteJobs/write |
| Microsoft.AgFoodPlatform/prescriptionMaps/escrever |
| Microsoft.AgFoodPlatform/prescriptionMaps/ler |
| Microsoft.AgFoodPlatform/prescriptionMaps/excluir |
| Microsoft.AgFoodPlatform/deletionJobs/prescriptionMapsCascadeDeleteJobs/write |
| Microsoft.AgFoodPlatform/managementZones/write |
| Microsoft.AgFoodPlatform/managementZones/read |
| Microsoft.AgFoodPlatform/managementZones/excluir |
| Microsoft.AgFoodPlatform/deletionJobs/managementZonescascadeDeletejobs/write |
| Microsoft.AgFoodPlatform/zonas/gravação |
| Microsoft.AgFoodPlatform/zonas/leitura |
| Microsoft.AgFoodPlatform/zonas/excluir |
| 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/excluir |
| Microsoft.AgFoodPlatform/deletionJobs/applicationDatacascadeDeletejob/write |
| Microsoft.AgFoodPlatform/plantingData/write |
| Microsoft.AgFoodPlatform/plantingData/read |
| Microsoft.AgFoodPlatform/plantingData/excluir |
| Microsoft.AgFoodPlatform/deletionJobs/plantingDatacascadeDeletejob/write |
| Microsoft.AgFoodPlatform/harvestingData/write |
| Microsoft.AgFoodPlatform/harvestingData/read |
| Microsoft.AgFoodPlatform/harvestingData/excluir |
| Microsoft.AgFoodPlatform/deletionJobs/harvestingDatacascadeDeletejob/write |
| Microsoft.AgFoodPlatform/tillageData/Escrever |
| Microsoft.AgFoodPlatform/tillageData/Ler |
| Microsoft.AgFoodPlatform/tillageData/Excluir |
| Microsoft.AgFoodPlatform/deletionJobs/tillageDatacascadeDeletejob/write |
SatelliteLogs
| operationName |
|---|
| Microsoft.AgFoodPlatform/ingestionJobs/satelliteDataingestionJob/write |
| Microsoft.AgFoodPlatform/cenas/leitura |
Registos meteorológicos
| 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/excluir |
| Microsoft.AgFoodPlatform/oauthTokens/read |
| Microsoft.AgFoodPlatform/oauthTokens/excluir |
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/processado/falhas |
| Microsoft.AgFoodPlatform/ingestionJobs/farmOperationPeriodicJobs/processed |
| Microsoft.AgFoodPlatform/ingestionJobs/farmOperationPeriodicJobs/processado/falhas |
| 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 nesta categoria. A diferença entre os logs nesta categoria e outras categorias para a mesma chamada de API é que, ApplicationAuditLogs não registra o corpo da solicitação, enquanto em outras categorias o corpo da solicitação é preenchido. Use o correlation-id para relacionar logs de duas categorias diferentes para obter mais detalhes. Algumas das operações do avião de controle que não fazem parte do resto das categorias estão listadas abaixo.
Nota
Para fazer chamadas de plano de controle, você precisa de acesso de proprietário no escopo de recursos do ADMA.
| operationName |
|---|
| Criar o Data Manager for Agriculture Resource |
| Atualizar o Gerenciador de Dados para Recursos Agrícolas |
| Excluir recurso do Gerenciador de Dados para Agricultura |
| Criar uma Subscrição |
| Atualizar Subscrição |
| Autenticação de plano de dados |
Consultar logs de recursos em um espaço de trabalho de análise de log
Todos os categories logs de recursos são mapeados como uma tabela na análise de logs. Para acessar logs para cada categoria, você precisa criar uma configuração de diagnóstico para enviar dados para um espaço de trabalho de análise de log. Neste espaço de trabalho, você pode consultar qualquer uma das tabelas listadas para obter os logs relevantes.
Lista de tabelas na análise de log e seu mapeamento para categorias em logs de recursos
| Nome da tabela na análise de log | Categorias em logs de recursos | Description |
|---|---|---|
| AgriFoodFarmManagementLogs | FarmManagementLogs | Logs para operações CRUD para festa, fazenda, campo, campo sazonal, colheita, colheita, safra, estação, anexo, mapas de prescrição, prescrições, zonas de manejo, zonas, análise de tecido vegetal e análises de nutrientes. |
| AgroAlimentarFarmOperationsLogs | FarmOperationsLogs | Logs para operações CRUD para o trabalho de ingestão de dados FarmOperations, ApplicationData, PlantingData, HarvestingData, TillageData. |
| AgriFoodSatelliteLogs | SatelliteLogs | Logs para criar e obter operações para o trabalho de ingestão de dados de satélite. |
| AgriFoodWeatherLogs | Registos meteorológicos | Logs para criar, excluir e obter operações para o trabalho de ingestão de dados meteorológicos. |
| AgriFoodProviderAuthLogs | ProviderAuthLogs | Logs para criar, atualizar, excluir, excluir em cascata, obter e obter tudo para provedores oauth. Ele também tem logs para obter, obter tudo, exclusão em cascata para tokens oauth. |
| AgriFoodInsightLogs | InsightLogs | Logs para obter e obter todas as operações para insights. |
| AgriFoodModelInferenceLogs | ModelInferenceLogs | Logs para criar e obter operações para o trabalho de modelo de biomassa. |
| AgroAlimentarTrabalhoProcessadoLogs | JobProcessedLogs | Logs para indicar sucesso ou falha e motivo de falha para trabalhos. Além de logs para trabalhos de exclusão em cascata de recursos, trabalhos de ingestão de dados. Ele também contém logs para operações de farm e trabalhos de manipulação de eventos. |
| AgriFoodApplicationAuditLogs | ApplicationAuditLogs | Logs para ações privilegiadas, como operações de criação, atualização, exclusão e gerenciamento de assinatura de recursos do plano de dados. |
Lista de colunas em tabelas de análise de log
| Nome do campo | Description |
|---|---|
| Tempo | Data e hora em UTC. |
| ResourceId | ID de recurso do Azure Resource Manager para logs do Data Manager for Agriculture. |
| Nome da operação | Nome da operação, conforme 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, isso pode ser qualquer valor, conforme listado na tabela de categorias. |
| Tipo de resultado | Resultado da solicitação da API REST (sucesso ou falha). |
| Assinatura do resultado | Estado de HTTP. |
| Descrição do Resultado | Mais descrição sobre o resultado, quando disponível. |
| DuraçãoMs | Tempo necessário para o processamento do pedido de API REST, em milissegundos. |
| CallerIpAddress | Endereço IP do cliente que fez o pedido. |
| 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 inquilino do chamador. |
| SubscriptionId | ID da assinatura usada pelo chamador. |
| Location | A região do recurso emissor do evento, como "Leste dos EUA" |
| JobRunType | Disponível somente na AgriFoodJobProcessesLogs tabela, indica o tipo de execução do trabalho. O valor pode ser periódico ou único. |
| JobId | Disponível emAgriFoodJobProcessesLogs, AgriFoodSatelliteLogs, AgriFoodWeatherLogse AgriFoodModelInferenceLogs, indica a ID do trabalho. |
| Iniciadopor | Disponível apenas na AgriFoodJobProcessesLogs tabela. 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 naAgriFoodJobProcessesLogs tabela, ele contém: farmOperationEntityId (ID da entidade que não conseguiu ser criada pelo trabalho farmOperation), farmOperationEntityType(Tipo da entidade que não conseguiu ser criada, pode ser ApplicationData, PeriodicJob, etc.), errorCode(Código para falha do trabalho no final do Data Manager for Agriculture),errorMessage(Descrição da falha no final do Data Manager for Agriculture),internalErrorCode(Código de 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 espaço de trabalho de análise de log. A referência para a linguagem de consulta está aqui.
Lista de consultas de exemplo no espaço de trabalho de análise de log
| Nome da consulta | Description |
|---|---|
| Situação das operações de gestão agrícola para uma parte | Obtém uma contagem de sucessos e fracassos de operações dentro da FarmManagementLogs categoria para cada parte. |
| Estatísticas de execução de trabalho para um grupo | Fornece uma contagem de sucessos e fracassos de todas as operações na JobProcessedLogs categoria para cada parte. |
| Falha na autorização | Identifica uma lista de usuários que não conseguiram acessar seu recurso e o motivo dessa falha. |
| Status de todas as operações para uma parte | Agrega fracassos e sucessos entre categorias para um grupo. |
| Tendências de uso para as 100 principais partes com base nas operações realizadas | Recupera uma lista dos 100 principais partidos 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 base para formar consultas personalizadas em um espaço de trabalho de análise de log. Essa lista de consultas também pode ser acessada Logs na guia em seu recurso do Azure Data Manager for Agriculture no portal do Azure.
Próximos passos
Saiba como configurar links privados.