Skip to main content
Skip to content

Migración de collectd a OpenTelemetry

En esta guía se describe la migración de una instancia de GitHub Enterprise Server de collectd a la pila de métricas de OpenTelemetry.

GitHub Enterprise Server está pasando de la pila de métricas de collectd a OpenTelemetry. Collectd queda obsoleto en la versión 3.23 y la actualización a 3.23 lo deshabilita.

Escala de tiempo de migración

VersiónValor predeterminado para las nuevas instalacionesComportamiento al actualizarNotas
3.18CollectdCollectdOpenTelemetry requiere activación explícita.
De 3.19 a 3.20OpenTelemetrySe conservan las opciones de configuración de métricas existentes.Las instancias que usan collectd pueden optar por usar OpenTelemetry.
De 3.21 a 3.22OpenTelemetryLas actualizaciones de versiones anteriores a la 3.21 habilitan OpenTelemetry y deshabilitan collectd. Las actualizaciones de la versión 3.21 o posterior conservan la configuración de métricas existente.Collectd todavía se puede volver a habilitar.
3.23 y versiones posterioresOpenTelemetryOpenTelemetry está habilitado y collectd está deshabilitado.Collectd se ha retirado y no se puede volver a habilitar.

Preparación para migrar

Antes de migrar, complete los siguientes preparativos:

  • Pruebe la migración en una instancia de ensayo antes de aplicarla en producción.
  • Identifique las integraciones de supervisión que dependen de las métricas de collectd, como paneles externos y alertas.
  • Si tiene previsto ejecutar ambas pilas de métricas durante un período de transición, revise las advertencias en Ejecución de ambas pilas de métricas.

Migrar a OpenTelemetry

Puede migrar manualmente a OpenTelemetry en instancias que ejecutan versiones 3.18 a 3.22. Si la instancia sigue usando recopilación, se recomienda migrar antes de actualizar a la versión 3.21 o posterior para que pueda comprobar la configuración de supervisión con antelación.

La actualización desde una versión anterior a la 3.21 a la 3.21 o 3.22 habilita automáticamente OpenTelemetry y deshabilita la recopilación, pero puede volver a habilitarla después de la actualización. La actualización a la versión 3.23 o posterior habilita OpenTelemetry y deshabilita collectd permanentemente.

La migración requiere habilitar las métricas de OpenTelemetry y deshabilitar collectd. Ambas opciones están disponibles a través de Consola de administración o de la línea de comandos.

Uso del Consola de administración

  1. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .

  2. Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.

  3. En la barra lateral " Site admin", haz clic en Consola de administración.

  4. En la configuración de supervisión, seleccione Habilitar OpenTelemetry.

  5. En Metrics - Collectd, seleccione Deshabilitar métricas de Collectd.

  6. En la barra lateral "Configuración" , haga clic en Guardar configuración.

    Nota:

    Al guardar la configuración en Consola de administración se restablecen los servicios del sistema, lo que podría generar un tiempo de inactividad visible para el usuario.

  7. Espera que se complete la fase de configuración.

Uso de la línea de comandos

  1. SSH en tu instancia de GitHub Enterprise Server. Si la instancia consta de varios nodos, por ejemplo, si la alta disponibilidad o la replicación geográfica están configuradas, utiliza SSH en el nodo principal. Si usas un clúster, puedes utilizar SSH en cualquier nodo. Reemplace HOSTNAME por el nombre de host de la instancia, o el nombre de host o la dirección IP de un nodo. Para más información, consulta Acceder al shell administrativo (SSH).

    Shell
    ssh -p 122 admin@HOSTNAME
    
  2. Para habilitar las métricas de OpenTelemetry y deshabilitar collectd, ejecute los siguientes comandos.

    ghe-config observability.metrics.next-enabled true
    ghe-config observability.metrics.legacy-disabled true
    
  3. Para aplicar la configuración, ejecuta el siguiente comando.

    Nota:

    Durante la ejecución de una configuración, los servicios de tu instancia de GitHub Enterprise Server pueden reiniciarse, y esto puede provocar un breve tiempo de inactividad para los usuarios.

    Shell
    ghe-config-apply
    
  4. Espera que se complete la fase de configuración.

Ejecución de ambas pilas de métricas

En la versión 3.18 a la 3.22, es posible ejecutar las pilas collectd y OpenTelemetry al mismo tiempo, pero no se recomienda. Esta configuración tiene las siguientes advertencias:

  • Algunos nombres de métricas pueden diferir para seguir siendo compatibles con el formato de collectd.
  • Algunas métricas de OpenTelemetry no incluyen etiquetas.
  • Se ha aumentado el uso de recursos para entregar métricas a ambas soluciones.

Collectd queda obsoleto en la versión 3.23, por lo que no es posible ejecutar ambas pilas después de actualizar.

Comprobaciones posteriores a la actualización

Una vez completada la ejecución de la configuración, tanto si ha migrado manualmente como si una actualización ha cambiado la instancia a OpenTelemetry:

Visualización de datos históricos de collectd

Desde las revisiones 3.22.3, 3.21.8, 3.20.10 y 3.19.14, la pestaña Supervisión incluye paneles de collectd para ver datos históricos. Estos paneles muestran las métricas de collectd registradas hasta el momento en que se deshabilitó la pila de collectd.