Registro de Azure Data Manager para Agricultura
Después de crear una instancia de recursos de Data Manager for Agriculture, puede supervisar cómo y cuándo se accede a los recursos y por quién. También puede depurar motivos de error para las solicitudes del plano de datos. Para ello, debe habilitar el registro para Azure Data Manager for Agriculture. Después, puede guardar la información de registro en un destino, como una cuenta de almacenamiento, un centro de eventos o un área de trabajo de Log Analytics, que proporcione.
En este artículo se proporcionan los pasos para configurar el registro para Azure Data Manager for Agriculture.
Habilitación de la recopilación de registros
Después de crear un recurso del servicio Data Manager for Agriculture, vaya a la configuración de diagnóstico y seleccione add diagnostics settings. Siga estos pasos para empezar a recopilar y almacenar registros:
- Proporcione un nombre para la configuración de diagnóstico.
- Seleccione las categorías para las que desea empezar a recopilar registros.
- Elija el destino de la recopilación de la cuenta de almacenamiento, el centro de eventos o un área de trabajo de Log Analytics.
Ahora puede ir al destino especificado en la configuración de diagnóstico para acceder a los registros. Puede acceder a la información de registro 10 minutos (como máximo) después de la operación de Data Manager for Agriculture. En la mayoría de los casos, es más rápido.
Interpretar los registros
Cada registro sigue el esquema que se muestra en la tabla. La tabla contiene los nombres de campo y las descripciones:
| Nombre del campo | Descripción |
|---|---|
| time | Fecha y hora en UTC. |
| resourceId | Identificador de recursos de Azure Resource Manager. En el caso de los registros, este es el identificador de recurso de Data Manager for Agriculture. |
| operationName | Nombre de la operación, como se documenta. |
| operationVersion | Versión de la API REST solicitada por el cliente. |
| category | Tipo de resultado. |
| resultType | Resultado de la solicitud de API de REST (correcto o erróneo). |
| resultSignature | Estado de HTTP |
| resultDescription | Descripción adicional sobre el resultado, cuando esté disponible. |
| durationMs | Tiempo que tardó en atender la solicitud de API de REST, en milisegundos. |
| callerIpAddress | Dirección IP del cliente que realizó la solicitud. |
| level | el nivel de gravedad del evento (informativo, advertencia, error o crítico). |
| correlationId | GUID opcional que se puede usar para correlacionar los registros. |
| identity | Identidad del token que se ha presentado al realizar la solicitud de la API REST. Suele ser un identificador de objeto y un identificador de aplicación o cualquiera de los dos. |
| ubicación | Región del recurso que emite el evento, como "Este de EE. UU." |
| properties | Para cada operationName contiene: requestUri (URI de la solicitud de API), partyId(partyId asociado a la solicitud, siempre que sea aplicable),dataPlaneResourceId (id. que identifica de forma única el recurso del plano de datos en la solicitud) y requestBody (contiene el cuerpo de la solicitud de la llamada API asociada al operationName para todas las categorías distintas de ApplicationAuditLogs). Aparte del común mencionado antes de jobProcessesLogs la categoría tiene: 1. Esta lista es de campos entre operationNames: jobRunType (puede ser oneTime o periódico), jobId (id. del trabajo), initiatedBy (indica si un trabajo lo desencadenó un usuario o el servicio). 2. Esta lista es de campos para trabajos relacionados con farmOperation con errores: farmOperationEntityId (identificador de la entidad que no pudo crear el trabajo farmOperation), farmOperationEntityType(tipo de entidad que no se pudo crear), errorCode(código para error de trabajo), errorMessage(descripción del error), internalErrorCode(código de error proporcionado por el proveedor), internalErrorMessage(descripción del error proporcionado por el proveedor), providerId(identificador del proveedor). |
El campo categories Data Manager for Agriculture puede tener valores que se enumeran en la tabla siguiente:
Tabla Categorías
| category | Descripción |
|---|---|
| FarmManagementLogs | Registros de operaciones CRUD para operaciones de parte, Granja, Campo, Campo estacional, Cosecha, CropVariety, Temporada, Datos adjuntos, mapas de prescripción, recetas, zonas de administración, zonas, análisis de tejidos vegetales y análisis de nutrientes. |
| FarmOperationsLogs | Registros de operaciones CRUD para el trabajo de ingesta de datos FarmOperations, ApplicationData, PlantingData, HarvestingData, TillageData |
| SatelliteLogs | Registros para crear y obtener operaciones para el trabajo de ingesta de datos satélite |
| WeatherLogs | Registros para crear, eliminar y obtener operaciones para el trabajo de ingesta de datos meteorológicos |
| ProviderAuthLogs | Registros para crear, actualizar, eliminar, eliminar en cascada, obtener y obtener todos para proveedores de Oauth. También tiene registros para obtener, obtener todo y eliminar en cascada los tokens de oauth. |
| JobProcessedLogs | Registros para indicar el éxito o el error y el motivo del error para los trabajos. Además de los registros de trabajos de eliminación en cascada de recursos, trabajos de ingesta de datos, también contiene registros para operaciones de granja de servidores y trabajos de control de eventos. |
| ModelInferenceLogs | Registros para crear y obtener operaciones para el trabajo del modelo de biomasa. |
| InsightLogs | Registros para obtener y obtener todas las operaciones para obtener información. |
| ApplicationAuditLogs | Registros de acciones con privilegios, como las operaciones de creación, actualización, eliminación y administración de suscripciones del plano de datos. La lista completa se encuentra en la tabla de nombres de operación siguiente. |
Los valores de campo operationName están en formato Microsoft.AgFoodPlatform/resource-name/read o write o delete o action.
/writesufijo en el nombre de la operación corresponde a una creación o actualización del nombre del recurso/readsufijo en el nombre de la operación corresponde a una llamada a la API GET/ LIST /GET ALL o al estado GET para un trabajo de eliminación en cascada para el nombre del recurso./deletesufijo corresponde a la eliminación del nombre del recurso./actionsufijo corresponde a llamadas de método POST para un nombre de recurso/processedsufijo corresponde a la finalización de un trabajo (una llamada al método PUT). Esto indica el estado del trabajo (correcto o erróneo)./failuressufijo corresponde al error de un trabajo de operación de granja de servidores (una llamada al método PUT) y contiene una descripción sobre el motivo del error.
La nomenclatura de trabajos es la siguiente:
- Para trabajos de ingesta de datos: Microsoft.AgFoodPlatform/ingestionJobs/<"resource-name">DataingestionJobs/write
- Para trabajos de eliminación: Microsoft.AgFoodPlatform/deletionJobs/<"resource-name">cascadeDeleteJobs/write
En la tabla siguiente se enumeran los valores de operationName y los comandos de API de REST correspondientes para una categoría como una pestaña:
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
Los registros de escritura y eliminación presentes en otras categorías también están presentes en esta categoría. La diferencia entre los registros de esta categoría y otras categorías para la misma llamada API es que, ApplicationAuditLogs no registra el cuerpo de la solicitud, mientras que en otras categorías se rellena el cuerpo de la solicitud. Use el identificador de correlación para relacionar los registros de dos categorías diferentes para obtener más detalles. A continuación se enumeran algunas de las operaciones del plano de control que no forman parte del resto de las categorías.
Nota:
Para realizar llamadas al plano de control, necesita acceso de propietario en el ámbito de recursos de ADMA.
| operationName |
|---|
| Creación de un recurso de Data Manager para Agricultura |
| Actualización de Data Manager para el recurso de agricultura |
| Eliminación de Data Manager para el recurso de agricultura |
| Crear suscripción |
| Actualizar suscripción |
| Autenticación del plano de datos |
Consulta de registros de recursos en un área de trabajo de Log Analytics
Todos los categories registros de recursos se asignan como una tabla en Log Analytics. Para acceder a los registros de cada categoría, debe crear una configuración de diagnóstico para enviar datos a un área de trabajo de Log Analytics. En esta área de trabajo, puede consultar cualquiera de las tablas enumeradas para obtener los registros pertinentes.
Lista de tablas de Log Analytics y su asignación a categorías en los registros de recursos
| Nombre de tabla en Log Analytics | Categorías en los registros de recursos | Descripción |
|---|---|---|
| AgriFoodFarmManagementLogs | FarmManagementLogs | Registros de operaciones CRUD para operaciones de parte, Granja, Campo, Campo estacional, Cosecha, CropVariety, Temporada, Datos adjuntos, mapas de prescripción, recetas, zonas de administración, zonas, análisis de tejidos vegetales y análisis de nutrientes. |
| AgriFoodFarmOperationsLogs | FarmOperationsLogs | Registros de operaciones CRUD para el trabajo de ingesta de datos FarmOperations, ApplicationData, PlantingData, HarvestingData, TillageData. |
| AgriFoodSatelliteLogs | SatelliteLogs | Registros para crear y obtener operaciones para el trabajo de ingesta de datos satélite. |
| AgriFoodWeatherLogs | WeatherLogs | Registros para crear, eliminar y obtener operaciones para el trabajo de ingesta de datos meteorológicos. |
| AgriFoodProviderAuthLogs | ProviderAuthLogs | Registros para crear, actualizar, eliminar, eliminar en cascada, obtener y obtener todos para los proveedores de oauth. También tiene registros para obtener, obtener todo y eliminar en cascada los tokens de oauth. |
| AgriFoodInsightLogs | InsightLogs | Registros para obtener y obtener todas las operaciones para obtener información. |
| AgriFoodModelInferenceLogs | ModelInferenceLogs | Registros para crear y obtener operaciones para el trabajo del modelo de biomasa. |
| AgriFoodJobProcessedLogs | JobProcessedLogs | Registros para indicar el éxito o el error y el motivo del error para los trabajos. Además de los registros de trabajos de eliminación en cascada de recursos, trabajos de ingesta de datos. También contiene registros para las operaciones de granja de servidores y los trabajos de control de eventos. |
| AgriFoodApplicationAuditLogs | ApplicationAuditLogs | Registros de acciones con privilegios, como las operaciones de creación, actualización, eliminación y administración de suscripciones del plano de datos. |
Lista de columnas en tablas de Log Analytics
| Nombre del campo | Descripción |
|---|---|
| Hora | Fecha y hora en UTC. |
| ResourceId | Identificador de recurso de Azure Resource Manager para los registros de Data Manager for Agriculture. |
| OperationName | Nombre de la operación, tal como se documenta en la tabla anterior. |
| OperationVersion | Versión de la API REST solicitada por el cliente. |
| Categoría | Detalles de categoría en los registros de Data Manager for Agriculture, puede ser cualquier valor como se muestra en la tabla de categorías. |
| ResultType | Resultado de la solicitud de API de REST (correcto o erróneo). |
| ResultSignature | Estado de HTTP |
| ResultDescription | Descripción adicional acerca del resultado, cuando está disponible. |
| DurationMs | Tiempo que tardó en atender la solicitud de API de REST, en milisegundos. |
| CallerIpAddress | Dirección IP del cliente que realizó la solicitud. |
| Nivel | Nivel de gravedad del evento (informativo, advertencia, error o crítico). |
| CorrelationId | GUID opcional que se puede usar para correlacionar los registros. |
| ApplicationId | Id. de aplicación que indica la identidad del autor de la llamada. |
| ObjectId | Id. de objeto que indica la identidad del autor de la llamada. |
| ClientTenantId | Identificador del inquilino del autor de la llamada. |
| SubscriptionId | Identificador de la suscripción usada por el autor de la llamada. |
| Ubicación | Región del recurso que emite el evento, como "Este de EE. UU." |
| JobRunType | Disponible solo en AgriFoodJobProcessesLogs tabla, indica el tipo de ejecución del trabajo. El valor puede ser periódico o de una vez. |
| JobId | Disponible enAgriFoodJobProcessesLogs, AgriFoodSatelliteLogs, AgriFoodWeatherLogs, y AgriFoodModelInferenceLogs, indica el identificador del trabajo. |
| InitiatedBy | Solo está disponible en AgriFoodJobProcessesLogs tabla. Indica si un usuario o el servicio inició un trabajo. |
| partyId | Identificador de la entidad asociada a la operación. |
| Propiedades | Disponible solo enAgriFoodJobProcessesLogs tabla, contiene: farmOperationEntityId (Identificador de la entidad que no pudo crear el trabajo farmOperation), farmOperationEntityType(tipo de la entidad que no se pudo crear, puede ser ApplicationData, PeriodicJob, etc.), errorCode(Código para el error del trabajo en Data Manager para el fin de la agricultura),errorMessage(Descripción del error en el extremo de Data Manager for Agriculture),internalErrorCode(Código de error del trabajo proporcionado por el proveedor),internalErrorMessage(Descripción del error proporcionado por el proveedor),providerId(Identificador del proveedor como JOHN-DEERE). |
Cada una de estas tablas se puede consultar mediante la creación de un área de trabajo de Log Analytics. La referencia del lenguaje de consulta se aquí.
Lista de consultas de ejemplo en el área de trabajo de Log Analytics
| Nombre de la consulta | Descripción |
|---|---|
| Estado de las operaciones de administración de granjas de servidores para una entidad | Captura un recuento de éxitos y errores de operaciones dentro de la categoría FarmManagementLogs para cada entidad. |
| Estadísticas de ejecución de trabajos para una entidad | Proporciona un recuento de éxitos y errores de para todas las operaciones de la categoría JobProcessedLogs para cada entidad. |
| Error de autorización | Identifica una lista de usuarios que no pudieron acceder al recurso y el motivo de este error. |
| Estado de todas las operaciones de una entidad | Agrega errores y éxitos entre categorías para una entidad. |
| Tendencias de uso de las 100 principales partes en función de las operaciones realizadas | Recupera una lista de los 100 principales partidos en función del número de visitas recibidas entre categorías. Esta consulta se puede editar para realizar un seguimiento de la tendencia de uso de una entidad determinada. |
Todas las consultas enumeradas anteriormente se pueden usar como consultas base para formar consultas personalizadas en un área de trabajo de Log Analytics. También se puede acceder a esta lista de consultas en la pestaña Logs del recurso de Azure Data Manager for Agriculture en Azure Portal.
Pasos siguientes
Obtenga información sobre cómo configurar vínculos privados.