Eventos de clúster Linux de Service Fabric en Syslog
Service Fabric expone un conjunto de eventos de la plataforma para informarle de actividad importante en el clúster. La lista completa de eventos expuestos está disponible aquí. Hay varias maneras de consumir estos eventos. En este artículo, vamos a explicar cómo configurar Service Fabric para escribir estos eventos en Syslog.
Nota:
Este artículo se ha actualizado recientemente para usar el término registros de Azure Monitor en lugar de Log Analytics. Los datos de registro siguen almacenándose en un área de trabajo de Log Analytics y siguen recopilándose y analizándose por el mismo servicio de Log Analytics. Estamos actualizando la terminología para reflejar mejor el rol de los registros de Azure Monitor. Consulte Azure Monitor terminology changes (Cambios en la terminología de Azure Monitor) para obtener más información.
Introducción
En la versión 6.4, se ha introducido SyslogConsumer para enviar los eventos de la plataforma de Service Fabric a Syslog para clústeres Linux. Una vez activados, los eventos fluirán automáticamente a Syslog, donde los recopilará y enviará el agente de Log Analytics.
Cada evento Syslog tiene 4 componentes:
- Facility
- Identidad
- Message
- severity
SyslogConsumer escribe todos los eventos de la plataforma mediante el recurso Local0
. Puede actualizar a cualquier instalación válida si cambia la configuración. La identidad utilizada es ServiceFabric
. El campo de mensaje contiene el evento completo serializado en JSON, por lo que pueden consultarlo y utilizarlo distintas herramientas.
Habilitar SyslogConsumer
Para habilitar SyslogConsumer, deberá realizar una actualización del clúster. La sección fabricSettings
debe actualizarse con el siguiente código. Tenga en cuenta que este código solo incluye las secciones relacionadas con SyslogConsumer.
"fabricSettings": [
{
"name": "Diagnostics",
"parameters": [
{
"name": "ConsumerInstances",
"value": "AzureWinFabCsv, AzureWinFabCrashDump, AzureTableWinFabEtwQueryable, SyslogConsumer"
}
]
},
{
"name": "SyslogConsumer",
"parameters": [
{
"name": "ProducerInstance",
"value": "WinFabLttProducer"
},
{
"name": "ConsumerType",
"value": "SyslogConsumer"
},
{
"name": "IsEnabled",
"value": "true"
}
]
},
{
"name": "Common",
"parameters": [
{
"name": "LinuxStructuredTracesEnabled",
"value": "true"
}
]
}
],
Estos son los cambios que se deben realizar:
- En la sección Común, hay un nuevo parámetro llamado
LinuxStructuredTracesEnabled
. Es necesario que los eventos de Linux estén estructurados y serializados cuando se envían a Syslog. - En la sección Diagnóstico, se a agregado un nuevo elemento ConsumerInstance: SyslogConsumer. Esto indica a la plataforma que hay otro consumidor de los eventos.
- La nueva sección SyslogConsumer debe tener
IsEnabled
comotrue
. Está configurada para utilizar el recurso Local0 automáticamente. Puede invalidar esto agregando otro parámetro.
{
"name": "New LogFacility",
"value": "<Valid Syslog Facility>"
}
Integración de los registros de Azure Monitor
Puede leer estos eventos de Syslog en una herramienta de supervisión como los registros de Azure Monitor. Puede crear un área de trabajo de Log Analytics con Azure Marketplace mediante estas [instrucciones].(../azure-monitor/logs/quick-create-workspace.md) También debe agregar el agente de Log Analytics al clúster para recopilar y enviar estos datos al área de trabajo. Este es el mismo agente que se usa para recopilar los contadores de rendimiento.
Navegue hasta la hoja
Advanced Settings
.Haga clic en
Data
Haga clic en
Syslog
Configure Local0 como el recurso del que realizar el seguimiento. Puede agregar otro recurso si lo cambia en fabricSettings.
Acceda al explorador de consultas; para ello, haga clic en
Logs
en el menú del recurso de área de trabajo para iniciar la consulta.Puede consultar la tabla
Syslog
si buscaServiceFabric
como ProcessName. La consulta siguiente es un ejemplo de cómo analizar el esquema JSON en el evento y mostrar su contenido.
Syslog | where ProcessName == "ServiceFabric" | extend $payload = parse_json(SyslogMessage) | project $payload
El ejemplo anterior es de un evento NodeDown. Puede ver la lista completa de eventos aquí.
Pasos siguientes
- Implemente el agente de Log Analytics en los nodos para recopilar contadores de rendimiento, así como estadísticas y registros de Docker de sus contenedores.
- Familiarícese con las características de consultas y búsqueda de registros que se ofrecen como parte de los registros de Azure Monitor.
- Uso del diseñador de vistas para crear vistas personalizadas en los registros de Azure Monitor
- Consulte esta referencia para obtener información sobre la integración de los registros de Azure Monitor con Syslog.
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de