Observabilidad

El adaptador de observabilidad ofrece registro automático, seguimiento distribuido en el estándar OpenTemetry y métricas. En la configuración es posible deshabilitar, configurar los ajustes de registro en el entorno de desarrollo local.

El parámetro ‘saveinfile’ activa la opción de guardar el registro localmente en la máquina del desarrollador. El elemento “HideDetails” oculta información en el registro y el elemento “ShowHttpErrors” controla la visualización de errores http en el registro.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

 "DevPrime_Observability": {
    "Enable": "true",
    "Log": {
      "Enable": "true",
      "Save": "false",
      "Type": "text",
      "FileSize": "5242880",
      "HideDetails": "false",
      "HideDateTime": "false",
      "ShowAppName": "false",
      "Path": "",
      "ShowHttpErrors": "400",
      "Export": {
        "Enable": "false",
        "Type": "seq",
        "Host": "http://localhost:5341",
        "ApiKey": "your api key",
        "ControlLevelSwitch": "Information"
      }
    },
    "Metrics": {
      "Enable": "false"
    },
    "Trace": {
      "Enable": "false",
      "Type": "zipkin",
      "Endpoint": "http://localhost:9411/api/v2/spans"
    }
  },
Observabilidad —
Habilitar Habilitar el adaptador de flujo (verdadero/falso)
Registro —
Habilitar Habilitar registros (Verdadero/Falso)
Guardar Habilitar el guardado en una ruta local
Tipo Configurar el formato (Text/Json)
Tamaño de archivo El tamaño máximo de cada archivo guardado
OcultarDetalles Ocultar los detalles de la carga útil en el registro (Verdadero/Falso)
OcultarFechaHora Ocultar la fecha y la hora en el registro (Verdadero/Falso)
ShowAppName Mostrar el nombre de la aplicación en el registro (Verdadero/Falso)
Camino La ruta de acceso de una carpeta local para guardar registros
ShowHttpErrors Mostrar en el registro errores HTTP (404, 500)
Exportación
Habilitar Habilita el registro de exportación (Verdadero/Falso)
Tipo Exportar los logs a los servicios (SEQ/Elastic)
Anfitrión URL de destino
ApiKey Clave de acceso a la URL de autenticación
ControlLevelSwitch
Métricas —
Habilitar Habilitar la exportación de métricas (verdadero/falso)
Rastro —
Habilitar Habilitar la exportación de seguimiento distribuido
Tipo Formato de exportación de OpenTelemetry (Zipkin/Jaeger)
Punto final URL de destino

Habilitación de la exportación local para Jarger

En este ejemplo, puede seguir una configuración de exportación de seguimiento distribuido (OpenTelemetry) a Jaeger.

1
2
3
4
5
6
7
8

  "Trace": {
      "enable": "true",
      "Type": "Jaeger",
      "Host": "localhost",
      "Port": "6831",
      "Endpoint": "http://localhost:14268",
      "Protocol": "UdpCompactThrift"
    }

Habilitación de la exportación local para Zipkin

En este ejemplo, puede seguir una configuración de exportación de seguimiento distribuido (OpenTelemetry) a Zipkin.

1
2
3
4
5

   "Trace": {
      "Enable": "true",
      "Type": "zipkin",
      "Endpoint": "http://localhost:9411/api/v2/spans"
    }

Información importante:

  • En el entorno de producción, especialmente en un clúster de Kubernetes, se recomienda encarecidamente implementar un recopilador como Fluentbit o soluciones similares para monitorear la salida predeterminada (stdout) de los contenedores y obtener registros para el destino de un destino.
  • Las plataformas en la nube ofrecen recopiladores con compatibilidad con OpenTelemetry

Explore ejemplos de implementación:

Última modificación January 10, 2024 (967dcac3)