Registros de diagnóstico para temas y dominios de Azure Event Grid

  • Artículo
  • Tiempo de lectura: 3 minutos

La configuración de diagnóstico permite a los usuarios de Event Grid capturar y ver los registros de errores de publicación y entrega en una cuenta de almacenamiento, un centro de eventos o un área de trabajo de Log Analytics. En este artículo se proporciona un esquema para los registros y una entrada de registro de ejemplo.

Esquema para registros de errores de publicación y entrega

Nombre de propiedad Tipo de datos Descripción
Time DateTime Hora a la que se generó la entrada de registro

Valor de ejemplo: 01-29-2020 09:52:02.700
EventSubscriptionName String El nombre de la suscripción de eventos

Valor de ejemplo: "EVENTSUB1"

Esta propiedad solo existe para los registros de errores de entrega.
Category String Nombre de la categoría del registro.

Valores de ejemplo: "DeliveryFailures" o "PublishFailures"
OperationName String El nombre de la operación que provocó el error.

Valores de ejemplo: "Deliver" para errores de entrega.
Message String Mensaje de registro para el usuario que explica el motivo del error y otros detalles adicionales.
ResourceId String El identificador de recurso para el recurso de tema/dominio

Valores de ejemplo:/SUBSCRIPTIONS/SAMPLE-SUBSCRIPTION-ID/RESOURCEGROUPS/SAMPLE-RESOURCEGROUP/PROVIDERS/MICROSOFT.EVENTGRID/TOPICS/TOPIC1

Ejemplo: Esquema para registros de errores de publicación y entrega

{
    "time": "2019-11-01T00:17:13.4389048Z",
    "resourceId": "/SUBSCRIPTIONS/SAMPLE-SUBSCTIPTION-ID /RESOURCEGROUPS/SAMPLE-RESOURCEGROUP-NAME/PROVIDERS/MICROSOFT.EVENTGRID/TOPICS/SAMPLE-TOPIC-NAME ",
    "eventSubscriptionName": "SAMPLEDESTINATION",
    "category": "DeliveryFailures",
    "operationName": "Deliver",
    "message": "Message:outcome=NotFound, latencyInMs=2635, id=xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx, systemId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx, state=FilteredFailingDelivery, deliveryTime=11/1/2019 12:17:10 AM, deliveryCount=0, probationCount=0, deliverySchema=EventGridEvent, eventSubscriptionDeliverySchema=EventGridEvent, fields=InputEvent, EventSubscriptionId, DeliveryTime, State, Id, DeliverySchema, LastDeliveryAttemptTime, SystemId, fieldCount=, requestExpiration=1/1/0001 12:00:00 AM, delivered=False publishTime=11/1/2019 12:17:10 AM, eventTime=11/1/2019 12:17:09 AM, eventType=Type, deliveryTime=11/1/2019 12:17:10 AM, filteringState=FilteredWithRpc, inputSchema=EventGridEvent, publisher=DIAGNOSTICLOGSTEST-EASTUS.EASTUS-1.EVENTGRID.AZURE.NET, size=363, fields=Id, PublishTime, SerializedBody, EventType, Topic, Subject, FilteringHashCode, SystemId, Publisher, FilteringTopic, TopicCategory, DataVersion, MetadataVersion, InputSchema, EventTime, fieldCount=15, url=sb://diagnosticlogstesting-eastus.servicebus.windows.net/, deliveryResponse=NotFound: The messaging entity 'sb://diagnosticlogstesting-eastus.servicebus.windows.net/eh-diagnosticlogstest' could not be found. TrackingId:c98c5af6-11f0-400b-8f56-c605662fb849_G14, SystemTracker:diagnosticlogstesting-eastus.servicebus.windows.net:eh-diagnosticlogstest, Timestamp:2019-11-01T00:17:13, referenceId: ac141738a9a54451b12b4cc31a10dedc_G14:"
}

Los valores posibles de Outcome son NotFound, Aborted, TimedOut, GenericError y Busy. Event Grid registra cualquier información que reciba del controlador de eventos en message. Por ejemplo, para GenericError, se registra el código de estado HTTP, el código de error y el mensaje de error.

Esquema para solicitudes de plano de datos

Nombre de propiedad Tipo de datos Descripción
NetworkAccess String Los valores permitidos son:
  • PublicAccess - cuando se conecta mediante una IP pública
  • PrivateAccess - cuando se conecta mediante un vínculo privado
ClientIpAddress String Dirección IP de origen de las solicitudes entrantes
TlsVersion String Versión de seguridad de la capa de transporte (TLS) que usa la conexión de cliente. Los valores posibles son 1.0, 1.1 y 1.2.
Authentication/Type String Tipo de secreto usado para la autenticación al publicar mensajes.
  • Key la solicitud usa la clave de SAS.
  • SASToken la solicitud usa un token de SAS generado a partir de la clave de SAS.
  • AADAccessToken token de JSON Web Token (JWT) emitido en Azure Active Directory.
  • Unknown ninguno de los tipos de autenticación anteriores. Las solicitudes de OPTIONS tendrán este tipo de autenticación
Authentication/ObjectId String ObjectId de la entidad de servicio que usó cuando el tipo de autenticación se estableció en AADAccessToken
OperationResult String Resultado de la publicación. Los valores posibles son:
  • Correcto
  • No autorizado
  • Prohibido
  • RequestEntityTooLarge
  • BadRequest
  • InternalServerError
TotalOperations String Estos seguimientos no se emiten para cada solicitud de publicación. Cada minuto se emite un agregado para cada combinación única de los valores anteriores.

Ejemplo: esquema para solicitudes de plano de datos

{
    "time": "2021-10-26T21:44:16.8117322Z",
    "resourceId": "/SUBSCRIPTIONS/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/RESOURCEGROUPS/BMT-TEST/PROVIDERS/MICROSOFT.EVENTGRID/DOMAINS/BMTAUDITLOGDOMAIN",
    "operationName": "Microsoft.EventGrid/events/send",
    "category": "DataPlaneRequests",
    "level": "Information",
    "region": "CENTRALUSEUAP",
    "properties": {
        "aggregatedRequests": [
            {
                "networkAccess": "PublicAccess",
                "clientIpAddress": "xx.xx.xx.xxx",
                "tlsVersion": "1.2",
                "authentication": {
                            "type": "AADAccessToken",
                            "objectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
                },
                "operationResult": "Success",
                "totalOperations": 1
            }
        ]
    }
}

Una vez seleccionada la configuración de diagnóstico DataPlaneRequests, los recursos de Event Grid comenzarán a publicar los seguimientos de auditoría de las operaciones del plano de datos, incluidas las operaciones de acceso público y privado. Este seguimiento puede registrar una o varias solicitudes si es necesario.

Pasos siguientes

Para aprender a habilitar registros de diagnóstico de temas o dominios, consulte Habilitación de registros de diagnóstico.