En la página, se describe cómo enviar métricas del Sincronizador de configuración a un exportador personalizado de OpenTelemetry.
El Sincronizador de configuración usa OpenCensus para crear y registrar métricas, y OpenTelemetry para exportar sus métricas. En esta página, se explica cómo configurar esas métricas en un exportador personalizado. Para conocer otras formas de exportar métricas, consulta Supervisa el Sincronizador de configuración con Cloud Monitoring o Supervisa el Sincronizador de configuración con Prometheus.
Configura un exportador personalizado de OpenTelemetry
Si deseas enviar tus métricas a un sistema de supervisión que no sea Prometheus ni Cloud Monitoring, puedes modificar la configuración de OpenTelemetry. Para obtener una lista de los sistemas de supervisión compatibles, consulta Exportadores de recopiladores de OpenTelemetry y Exportadores de colector de OpenTelemetry.
Los recursos de supervisión de OpenTelemetry se administran en un espacio de nombres config-management-monitoring independiente. Si deseas configurar un exportador personalizado de OpenTelemetry para usarlo con el Sincronizador de configuración, debes crear un ConfigMap con el nombre otel-collector-custom en ese espacio de nombres config-management-monitoring.
El ConfigMap debe contener una clave otel-collector-config.yaml y el valor debe ser el contenido del archivo de la configuración personalizada del recopilador de OpenTelemetry.
Para obtener más información sobre las opciones de configuración, consulta la documentación de configuración del recopilador de OpenTelemetry.
El siguiente ConfigMap es un ejemplo de un ConfigMap con un exportador de registros personalizado:
# otel-collector-custom-cm.yaml
apiVersion: v1
kind: ConfigMap
metadata:
name: otel-collector-custom
namespace: config-management-monitoring
labels:
app: opentelemetry
component: otel-collector
data:
otel-collector-config.yaml: |
receivers:
opencensus:
exporters:
logging:
logLevel: debug
processors:
batch:
extensions:
health_check:
service:
extensions: [health_check]
pipelines:
metrics:
receivers: [opencensus]
processors: [batch]
exporters: [logging]
Todas la configuración personalizada debe definir un receptor opencensus y una canalización metrics. Los otros campos son opcionales y configurables, pero te recomendamos incluir un procesador batch y una extensión de verificación de estado, como en el ejemplo.
Después de crear el ConfigMap, usa kubectl para crear el recurso:
kubectl apply -f otel-collector-custom-cm.yaml
La implementación del recopilador de OpenTelemetry toma este ConfigMap y se reinicia de forma automática para aplicar la configuración personalizada.
Limitaciones
Cuando actualices el Sincronizador de configuración a una versión nueva, si creaste un ConfigMap otel-collector-custom para una versión anterior, es posible que la configuración personalizada no sea compatible con la nueva versión del Sincronizador de configuración. Por ejemplo, los nombres, las etiquetas y los atributos de las métricas pueden cambiar entre las versiones de Sincronizador de configuración.
Cuando se realizan cambios en las métricas de Sincronizador de configuración, se anuncian en las notas de la versión. Es posible que estos cambios requieran que actualices tu configuración personalizada de otel-collector.
Debido a esta limitación, te recomendamos que solo uses configuraciones de métricas personalizadas para soluciones temporales. Si consideras que necesitas usar una configuración personalizada, envía un ticket de asistencia para solicitar la solución como una función o una corrección de errores.