Habilitación de los registros de diagnóstico de recursos de Event Grid

En este artículo se proporcionan instrucciones paso a paso sobre cómo habilitar la configuración de diagnóstico para los recursos de Event Grid. La configuración de diagnóstico recoge información sobre fallos de publicación y entrega para que puedas diagnosticar y solucionar problemas con tus recursos de la Grid de Eventos. La siguiente tabla muestra los ajustes disponibles para diferentes tipos de recursos de la Cuadrícula de Eventos: temas personalizados, temas del sistema y dominios.

Prerrequisitos

• Recurso de Event Grid aprovisionado
• Destino aprovisionado para capturar registros de diagnóstico:
  • Área de trabajo de Log Analytics
  • Cuenta de almacenamiento
  • Event Hubs
  • Solución para socios

Habilitación de registros de diagnóstico para Event Grid temas y dominios

1. Inicie sesión en Azure Portal.

2. Vaya al tema de Event Grid para el que desee habilitar la configuración del registro de diagnóstico.

   1. En la barra de búsqueda de la parte superior, busque Temas de Event Grid.

      

   2. Seleccione el tema de la lista para el que desea configurar las opciones de diagnóstico.

3. Seleccione Configuración de diagnóstico en Supervisión, en el menú de la izquierda.

4. En la página Configuración de diagnóstico, seleccione Agregar configuración de diagnóstico.

   

5. Introduce un nombre para la configuración de diagnóstico.

6. Seleccione la opción allLogs en la sección Registros.

   

7. Habilita uno o más de los destinos de captura para los registros y luego configúralos seleccionando un recurso de captura creado previamente.

   • Si selecciona Send to Log Analytics (Enviar a Log Analytics), seleccione un área de trabajo de Log Analytics.

     

   • Si selecciona Archive to a storage account (Archivar en una cuenta de almacenamiento), seleccione Cuenta de almacenamiento: configurar y, a continuación, seleccione la cuenta de almacenamiento en la suscripción de Azure.

     

   • Si selecciona Stream to an event hub (Transmitir a un centro de eventos), seleccione Centro de eventos: Configurar y, a continuación, seleccione el espacio de nombres de Event Hubs, el centro de eventos y la directiva de acceso.

     

8. Seleccione Guardar. Luego, selecciona X en la esquina superior derecha para cerrar la página.

9. De vuelta en la página de configuración de diagnóstico , confirma que ves una nueva entrada en la tabla de configuración de diagnóstico .

   

También puede habilitar la recopilación de todas las métricas del tema.

Habilitar los registros de diagnóstico para los temas del sistema de Event Grid

1. Inicie sesión en Azure Portal.

2. Ve al tema del sistema donde quieres activar la configuración de registros de diagnóstico.

   1. En la barra de búsqueda de la parte superior, busque Event Grid system topics (Temas del sistema de Event Grid).

      

   2. Selecciona el tema del sistema donde quieras configurar la configuración de diagnóstico.

      

3. Seleccione Configuración de diagnóstico en Supervisión en el menú izquierdo y, luego, elija Agregar configuración de diagnóstico.

   

4. Introduce un nombre para la configuración de diagnóstico.

5. Seleccione la opción allLogs en la sección Registros.

   

6. Habilita uno o más de los destinos de captura para los registros y luego configúralos seleccionando un recurso de captura creado previamente.

   • Si selecciona Send to Log Analytics (Enviar a Log Analytics), seleccione un área de trabajo de Log Analytics.

     

   • Si selecciona Archive to a storage account (Archivar en una cuenta de almacenamiento), seleccione Cuenta de almacenamiento: configurar y, a continuación, seleccione la cuenta de almacenamiento en la suscripción de Azure.

     

   • Si selecciona Stream to an event hub (Transmitir a un centro de eventos), seleccione Centro de eventos: Configurar y, a continuación, seleccione el espacio de nombres de Event Hubs, el centro de eventos y la directiva de acceso.

     

7. Seleccione Guardar. Luego, selecciona X en la esquina superior derecha para cerrar la página.

8. De vuelta en la página de configuración de diagnóstico , confirma que ves una nueva entrada en la tabla de configuración de diagnóstico .

   

También puedes habilitar la recopilación de todas las métricas para el tema del sistema.

Visualización de registros de diagnóstico en Azure Storage

1. Cuando activas una cuenta de almacenamiento como destino de captura, Event Grid empieza a emitir registros de diagnóstico. Ves nuevos contenedores llamados insights-logs-deliveryfailures e insights-logs-publishfailures en la cuenta de almacenamiento.

   

2. Mientras navegas por uno de los contenedores, llegas a una mancha en formato JSON. El archivo contiene entradas de registro para un error de entrega o un error de publicación. La ruta de navegación representa el ResourceId del tema de la Cuadrícula de Eventos y la marca de tiempo (nivel de minutos) cuando la Cuadrícula de Eventos emitió las entradas de registro. El archivo blob/JSON, que puedes descargar, sigue el esquema descrito en la siguiente sección.

   

3. Ves contenido en el archivo JSON similar al siguiente ejemplo:

   {
       "time": "2019-11-01T00:17:13.4389048Z",
       "resourceId": "/SUBSCRIPTIONS/SAMPLE-SUBSCRIPTION-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=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx, systemId=xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, 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=SAMPLE-TOPIC-NAME.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://sample-namespace.servicebus.windows.net/, deliveryResponse=NotFound: The messaging entity 'sb://sample-namespace.servicebus.windows.net/sample-eventhub' could not be found. TrackingId:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_G14, SystemTracker:sample-namespace.servicebus.windows.net:sample-eventhub, Timestamp:2019-11-01T00:17:13, referenceId: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_G14:"
   }
   

Usar plantillas de Azure Resource Manager

Esta es una plantilla de ejemplo de Azure Resource Manager para habilitar la configuración de diagnóstico de un tema de Event Grid. Cuando despliegas esta plantilla de ejemplo, se crean los siguientes recursos:

• Un tema de Event Grid
• Un área de trabajo de Log Analytics

A continuación, crea una configuración de diagnóstico en el tema para enviar información de diagnóstico al área de trabajo de Log Analytics.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "topic_name": {
            "defaultValue": "spegrid0917topic",
            "type": "String"
        },
        "log_analytics_workspace_name": {
            "defaultValue": "splogaw0625",
            "type": "String"
        },
        "location": {
            "defaultValue": "eastus",
            "type": "String"
        },
        "sku": {
            "defaultValue": "Free",
            "type": "String"
        }
    },
    "variables": {},
    "resources": [
        {
            "type": "Microsoft.EventGrid/topics",
            "apiVersion": "2020-10-15-preview",
            "name": "[parameters('topic_name')]",
            "location": "[parameters('location')]",
            "sku": {
                "name": "Basic"
            },
            "kind": "Azure",
            "identity": {
                "type": "None"
            },
            "properties": {
                "inputSchema": "EventGridSchema",
                "publicNetworkAccess": "Enabled"
            }
        },
        {
            "apiVersion": "2017-03-15-preview",
            "name": "[parameters('log_analytics_workspace_name')]",
            "location": "[parameters('location')]",
            "type": "Microsoft.OperationalInsights/workspaces",
            "properties": {
                "sku": {
                    "name": "[parameters('sku')]"
                }
            }
        },
        {
            "type": "Microsoft.EventGrid/topics/providers/diagnosticSettings",
            "apiVersion": "2017-05-01-preview",
            "name": "[concat(parameters('topic_name'), '/', 'Microsoft.Insights/', parameters('log_analytics_workspace_name'))]",
            "location": "[parameters('location')]",
            "dependsOn": [
                "[resourceId('Microsoft.EventGrid/topics', parameters('topic_name'))]",
                "[resourceId('Microsoft.OperationalInsights/workspaces', parameters('log_analytics_workspace_name'))]"
            ],
            "properties": {
                "workspaceId": "[resourceId('Microsoft.OperationalInsights/workspaces', parameters('log_analytics_workspace_name'))]",
                "metrics": [
                    {
                        "category": "AllMetrics",
                        "enabled": true
                    }
                ],
                "logs": [
                    {
                        "category": "DeliveryFailures",
                        "enabled": true
                    },
                    {
                        "category": "PublishFailures",
                        "enabled": true
                    }
                ]
            }
        }
    ]
}

Habilitación de los registros de diagnóstico para seguimientos de auditoría

Event Grid puede publicar seguimientos de auditoría para las operaciones del plano de datos. Para habilitar la característica, seleccione auditar en la sección Grupos de categorías o seleccione DataPlaneRequests en la sección Categorías.

Utiliza el rastreo de auditoría para asegurarte de que el acceso a los datos solo se permite para fines autorizados. Recopila información sobre controles de seguridad, como nombre del recurso, tipo de operación, acceso a la red, nivel y región. Para más información sobre cómo activar la configuración de diagnóstico, consulte Habilitar registros de diagnóstico para temas y dominios de la Cuadrícula de Eventos.

Pasos siguientes

Para obtener el esquema de registro y otra información conceptual sobre los registros de diagnóstico de temas o dominios, consulte Registros de diagnóstico.