Ejemplo de Secuencia de Comandos: Registro

Logging aprovecha la API de registro de Microsoft. El registro ayuda a depurar y mantener un complemento, brindando información sobre los valores actuales y los comportamientos esperados e inesperados. El ejemplo de este artículo demuestra cómo registrar mensajes.

Gravedad del Registro

Solo se registrará un mensaje si el nivel de gravedad es igual o superior al valor configurado en Gravedad mínima en Configuración de registro del servidor de aplicaciones para cada configuración de destino de registro (memoria, base de datos y disco).

Niveles de Gravedad

Gravedad de Microsoft	App Builder gravedad	Descripción
`Off`	`Off`	Estado de configuración donde el registro de destino no escribirá ningún mensaje, no está destinado para su uso durante el registro.
`Trace`	`Trace`	Mensaje detallado de pasos minuciosos, este estado debe evitarse en ambientes de producción.
`Debug`	`Debug`	Se utiliza durante el desarrollo para investigar el estado y el comportamiento.
`Information`	`Info`	Se utiliza para rastrear el comportamiento esperado, por ejemplo, el procesamiento exitoso de un archivo.
`Warning`	`Warn`	Se utiliza cuando un comportamiento o estado aún no es perjudicial, pero debe tenerse en cuenta, por ejemplo, cuando el disco se queda sin espacio.
`Error`	`Error`	Se utiliza cuando el proceso actual debe detenerse debido a un fallo, por ejemplo, un valor de datos inesperado de un archivo.
`Critical`	`Fatal`	Se utiliza cuando una falla requiere atención inmediata.

Pantalla de configuración del servidor de aplicaciones, que ilustra la gravedad de la información establecida para la configuración del registro de memoria

Secuencia de Comandos

using Microsoft.Extensions.Logging;

var logger = Services.GetRequiredService<ILogger>();

logger.LogWarning("My warning message");

imagen

Alcance

Se admite el alcance y permite agregar información adicional al registro.

using Microsoft.Extensions.Logging;
using System.Collections.Generic;

var logger = Services.GetRequiredService<ILogger>();

logger.LogError("My unscoped error message");

// Appends "MyScope" to the log source
using (logger.BeginScope("MyScope")) {

    logger.LogWarning("My scoped warning");

    // Tags log records with the extra identifing properties.
    using (logger.BeginScope(new Dictionary<string, object>{
       `["Identificador del cliente"] `= 123,
       `["ID de pedido"] `= 12
    })) {

        logger.LogWarning("My warning with extra data");

    }
}

Ejemplo de salida de registros de memoria con alcance configurado

Nota

Cualquier propiedad agregada por el alcance será protegida, lo que significa que se registrará y mostrará Registrar datos seguros tiene que ser ON.

Más Información

Puede encontrar más información sobre la API de registrador de Microsoft así como sus métodos de extensión en el Navegador de API .NET de Microsoft.