Habilitación del registro de diagnóstico para Microsoft Foundry

En este artículo se proporcionan instrucciones paso a paso para habilitar el registro de diagnóstico para un recurso de Microsoft Foundry. Estos registros proporcionan datos completos y frecuentes sobre el funcionamiento de un recurso que puede usar para la identificación y depuración de problemas. Antes de continuar, debe tener una cuenta de Azure con una suscripción a al menos un recurso Microsoft Foundry.

Prerequisites

Para habilitar el registro de diagnóstico, debe seleccionar una ubicación para almacenar los datos de registro. En este tutorial se utiliza Azure Storage y Log Analytics.

• Azure Storage: conserva los registros de diagnóstico para auditorías de directivas, análisis estáticos o copias de seguridad. La cuenta de almacenamiento no necesita estar en la misma suscripción que el recurso que emite los registros, siempre que el usuario que configure el ajuste tenga el acceso adecuado al control de acceso basado en roles de Azure (RBAC) en ambas suscripciones.
• Log Analytics: herramienta flexible de búsqueda y análisis de registros que puede usar para analizar los registros sin procesar generados por un recurso de Azure.

Habilitación de la colección de registros de diagnóstico

Para empezar, habilite el registro de diagnóstico mediante el portal de Azure.

1. Vaya al portal Azure. A continuación, busque y seleccione un recurso Microsoft Foundry.
2. A continuación, en el menú de navegación izquierdo, busque Supervisión y seleccione Configuración de diagnóstico. Esta pantalla contiene todas las configuraciones de diagnóstico creadas anteriormente para este recurso.
3. Si hay una configuración de diagnóstico creada anteriormente que desea usar, selecciónela ahora. En caso contrario, seleccione + Add diagnostic setting (+ Agregar configuración de diagnóstico).
4. Escriba un nombre para la configuración. Seleccione Archive to a storage account (Archivar en una cuenta de almacenamiento) y luego seleccione Send to log Analytics (Enviar a Log Analytics).
5. Cuando se le pida que configure, seleccione la cuenta de almacenamiento y el área de trabajo de OMS que desea usar para almacenar los registros de diagnóstico.

   Note

   Si no tiene una cuenta de almacenamiento o un área de trabajo de OMS, siga las indicaciones para crear una.

6. Seleccione Registros de auditoría, Registros de solicitudes y respuestas, Uso de solicitudes de Azure OpenAI y AllMetrics. Para obtener una descripción de cada categoría de registro disponible, consulte la referencia de datos de supervisión de Azure OpenAI.
7. Seleccione Guardar.

Los datos de registro pueden tardar hasta dos horas en consultarse y analizarse, por lo que no se preocupe si no ve nada inmediatamente.

Visualización de registros en Azure Storage

Al enrutar los registros de diagnóstico a una cuenta de almacenamiento, Azure Monitor escribe los registros de registro emitidos como blobs JSON. Cada categoría de registro se almacena en su propio contenedor denominado insights-logs-<category> (por ejemplo, insights-logs-audit o insights-logs-requestresponse).

1. En el portal de Azure, busque el recurso de Azure Storage que seleccionó al habilitar la configuración de diagnóstico.
2. En el menú de navegación izquierdo, busque Almacenamiento de datos y seleccione Contenedores.
3. Seleccione el insights-logs-<category> contenedor de la categoría de registro que desea revisar, como insights-logs-requestresponse.
4. Profundice en la ruta de acceso del blob para encontrar los registros de su recurso y el intervalo de tiempo. Los blobs se organizan por identificador de recurso y marca de tiempo, por ejemplo: resourceId=/SUBSCRIPTIONS/.../PROVIDERS/MICROSOFT.COGNITIVESERVICES/ACCOUNTS/<resource-name>/y=<year>/m=<month>/d=<day>/h=<hour>/m=00/PT1H.json.
5. Seleccione el PT1H.json blob y, a continuación, seleccione Descargar para guardarlo. Cada blob contiene JSON delimitado por líneas, donde cada línea es un registro de registro único.

Para más información sobre cómo se almacenan los registros de diagnóstico, consulte registros de recursos de Azure. Para obtener información sobre lo que puede hacer con los datos de blobs en Azure Storage, consulte Azure Storage.

Visualización de los registros de Log Analytics

Siga estas instrucciones para explorar los datos de análisis de registros para el recurso.

1. En Azure Portal, localice y seleccione Log Analytics en el menú de navegación izquierdo.
2. Busque y seleccione el recurso que ha creado cuando se habilita el diagnóstico.
3. En General, busque y seleccione Logs (Registros). Desde esta página, puede realizar las consultas en los registros.

Consultas de ejemplo

Estas son algunas consultas básicas de Kusto que puede utilizar para explorar los datos de registro.

Ejecute esta consulta para todos los registros de diagnóstico del recurso Microsoft Foundry durante un período de tiempo especificado:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"

Ejecute esta consulta para medir la latencia de solicitud por código de respuesta, incluidos los percentiles P50, P90, P95 y P99:

AzureDiagnostics
| where TimeGenerated between (todatetime('<StartDateTime>') .. todatetime('<EndDateTime>'))
| where ResourceId has "<YourResourceID>"
| where Category == "RequestResponse"
| project TimeGenerated, ResponseCode = ResultSignature, DurationMs, OperationName
| summarize
    RequestCount = count(),
    P50 = percentile(DurationMs, 50),
    P90 = percentile(DurationMs, 90),
    P95 = percentile(DurationMs, 95),
    P99 = percentile(DurationMs, 99)
    by ResponseCode, OperationName
| order by RequestCount desc

Ejecute esta consulta para medir el recuento de solicitudes por código de respuesta:

AzureDiagnostics
| where TimeGenerated between (todatetime('<StartDateTime>') .. todatetime('<EndDateTime>'))
| where ResourceId has "<YourResourceID>"
| where Category == "RequestResponse"
| project TimeGenerated, ResponseCode = ResultSignature
| summarize RequestCount = count() by ResponseCode
| order by RequestCount desc

Ejecute esta consulta para ver todas las métricas emitidas:

AzureMetrics
| where TimeGenerated between (todatetime('<StartDateTime>') .. todatetime('<EndDateTime>'))
| project MetricName, Total, Count, Maximum, Minimum, Average, TimeGrain, UnitName

Pasos siguientes

• Para las categorías de registro de recursos disponibles, las tablas de Log Analytics asociadas y los esquemas de registro, consulte Referencia de datos de supervisión de Azure OpenAI.
• Para comprender cómo habilitar el registro y las métricas y las categorías de registro compatibles con los distintos servicios de Azure, lea información general sobre las métricas en Microsoft Azure y la introducción a los registros de diagnóstico de Azure.
• Consulte Descripción de las búsquedas de registros en los registros de Azure Monitor.