Azure Data Manager para log de Agricultura

Depois de criar uma instância de recurso do Data Manager for Agriculture, 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 as 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:

1. Forneça um nome para a configuração de diagnóstico.
2. Selecione as categorias para as quais você deseja começar a coletar logs.
3. 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 logs. Você pode acessar suas informações de registro 10 minutos (no máximo) após a operação do Gerenciador de Dados para Agricultura. Na maioria dos casos, é mais rápido.

Interpretar seus logs

Cada log segue o esquema listado na tabela. A tabela contém os nomes e descrições dos campos:

Nome do campo	Descrição
time	Data e hora em UTC.
resourceId	ID do Recurso do Azure Resource Manager. Para logs, essa é a ID do 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 (êxito ou falha).
resultSignature	Código de status HTTP.
resultDescription	Descrição extra 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 é um ID de objeto e um ID de aplicativo ou qualquer um dos dois.
local	A região do recurso que emite o evento, como "Leste dos EUA"
properties	Para cada operationName um deles isso contém: requestUri (URI da solicitação de API), (partyId associado à solicitação, sempre que aplicável), partyIddataPlaneResourceId (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 categoria tem: 1. Esta lista é de campos em operationNames: jobRunType (pode ser oneTime ou periodic), (ID do trabalho), jobIdinitiatedBy (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: (ID da entidade que não foi criada pelo trabalho farmOperation), (tipo da entidade que não foi criada), (código para falha de trabalho), (descrição de falha), (código de falha fornecido pelo provedor), (descrição da falha fornecida pelo provedor), internalErrorMessagefarmOperationEntityTypeproviderIderrorCodeinternalErrorCodeerrorMessage(ID do provedor).farmOperationEntityId

O categories campo do Gerenciador de Dados para Agricultura pode ter valores listados na tabela a seguir:

Tabela de categorias

category	Descrição
FarmManagementLogs	Toras para operações CRUD para festa, Fazenda, Campo, Campo Sazonal, Safra, SafraVariedade, 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 trabalho de ingestão de dados FarmOperations, ApplicationData, PlantingData, HarvestingData, TillageData
SatelliteLogs	Logs para criar e obter operações para o trabalho de ingestão de dados de satélite
WeatherLogs	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	Toras 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	Registra ações privilegiadas, como operações de criação, atualização, exclusão e gerenciamento de assinaturas 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 no formato Microsoft.AgFoodPlatform/resource-name/read ou write ou delete ou action .

• /write sufixo 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
• /delete sufixo corresponde à exclusão do nome-do-recurso
• /action sufixo corresponde a chamadas de método POST para um nome de recurso
• /processed sufixo corresponde à conclusão de um trabalho (uma chamada de método PUT). Isso indica o status do trabalho (sucesso ou fracasso).
• /failures sufixo corresponde à falha de um trabalho de operação de farm (uma chamada de 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 da API REST correspondentes para uma categoria como uma guia:

FarmManagementLogs

operationName
Microsoft.AgFoodPlatform/farmers/write
Microsoft.AgFoodPlatform/agricultores/leitura
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/limites/gravação
Microsoft.AgFoodPlatform/limites/leitura
Microsoft.AgFoodPlatform/limites/excluir
Microsoft.AgFoodPlatform/limites/ação
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/anexos/gravação
Microsoft.AgFoodPlatform/anexos/leitura
Microsoft.AgFoodPlatform/attachments/delete
Microsoft.AgFoodPlatform/prescrições/gravação
Microsoft.AgFoodPlatform/prescrições/leitura
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/plantTissueanálises/leitura
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/cenas/leitura

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 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.

operationName
Criar Gerenciador de Dados para Recursos de Agricultura
Atualizar o Gerenciador de Dados para Recursos de Agricultura
Excluir o Gerenciador de Dados para Recursos de Agricultura
Criar Assinatura
Atualizar Assinatura
Autenticação do 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	Descrição
AgriFoodFarmManagementLogs	FarmManagementLogs	Toras para operações CRUD para festa, Fazenda, Campo, Campo Sazonal, Safra, SafraVariedade, Estação, Anexo, mapas de prescrição, prescrições, zonas de manejo, zonas, análise de tecido vegetal e análises de nutrientes.
AgriFoodFarmOperationsLogs	FarmOperationsLogs	Logs para operações CRUD para trabalho de ingestão de dados FarmOperations, ApplicationData, PlantingData, HarvestingData, TillageData.
AgriFoodSatelliteLogs	SatelliteLogs	Logs para criar e obter operações para trabalho de ingestão de dados de satélite.
AgriFoodWeatherLogs	WeatherLogs	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	Toras para criar e obter operações para o trabalho de modelo de biomassa.
AgriFoodJobProcessedLogs	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	Registra ações privilegiadas, como operações de criação, atualização, exclusão e gerenciamento de assinaturas de recursos do plano de dados.

Lista de colunas em tabelas de análise de log

Nome do campo	Descrição
Hora	Data e hora em UTC.
ResourceId	ID de recurso do Gerenciador de Recursos do Azure para logs do Gerenciador de Dados para Agricultura.
OperationName	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 categoria.
ResultType	Resultado da solicitação da API REST (êxito ou falha).
ResultSignature	Código de status HTTP.
ResultadoDescrição	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, de aviso, de erro ou crítico).
CorrelationId	Um GUID opcional que pode ser usado para correlacionar logs.
ApplicationId	ID do aplicativo indicando a identidade do chamador.
ObjectId	ID do objeto indicando a identidade do chamador.
ClientTenantId	ID do locatário do chamador.
SubscriptionId	ID da assinatura usada pelo chamador.
Localização	A região do recurso que emite o 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, , e AgriFoodModelInferenceLogs, AgriFoodSatelliteLogsAgriFoodWeatherLogsindica a ID do trabalho.
Iniciado por	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 foi criada pelo trabalho farmOperation), (Tipo da entidade que não foi criada, pode ser ApplicationData, PeriodicJob, etc.), (Código para falha do trabalho no Data Manager for Agriculture end),(Descrição da falha no Data Manager for Agriculture end),errorMessageinternalErrorCode(Código de falha do trabalho fornecido pelo provedor), farmOperationEntityTypeerrorCodeinternalErrorMessage(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	Descrição
Status das operações de gerenciamento de farm para uma parte	Busca uma contagem de sucessos e fracassos de operações dentro da FarmManagementLogs categoria para cada parte.
Estatísticas de execução de trabalho para uma parte	Fornece uma contagem de sucessos e fracassos de para 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 de uma parte	Agrega fracassos e sucessos em todas as categorias de um partido.
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 um determinado grupo.

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óximas etapas

Saiba como configurar links privados.