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ón | Valor predeterminado para las nuevas instalaciones | Comportamiento al actualizar | Notas |
|---|---|---|---|
| 3.18 | Collectd | Collectd | OpenTelemetry requiere activación explícita. |
| De 3.19 a 3.20 | OpenTelemetry | Se 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.22 | OpenTelemetry | Las 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 posteriores | OpenTelemetry | OpenTelemetry 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
-
Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .
-
Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.
-
En la barra lateral " Site admin", haz clic en Consola de administración.
-
En la configuración de supervisión, seleccione Habilitar OpenTelemetry.
-
En Metrics - Collectd, seleccione Deshabilitar métricas de Collectd.
-
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.
-
Espera que se complete la fase de configuración.
Uso de la línea de comandos
-
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
ssh -p 122 admin@HOSTNAME -
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 -
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
ghe-config-apply -
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:
- Compruebe que las métricas están visibles y recopiladas en la pestaña Supervisión de la Consola de administración.
- Actualice las integraciones de supervisión que dependen de las métricas de collectd. Para obtener información sobre cómo conectar herramientas externas, consulte Configuración de la supervisión externa con OpenTelemetry.
- Para obtener información sobre el análisis de métricas, consulte Uso de Grafana para analizar métricas de 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.