Módulo de telemetría

Editar en línea

El módulo de telemetría envía datos sobre el clúster de almacenamiento para ayudar a comprender cómo se utiliza Ceph y qué problemas se encuentran durante las operaciones. Los datos se visualizan en el panel de control público para ver las estadísticas de resumen sobre cuántos clústeres se notifican, su capacidad total y recuento de OSD, y las tendencias de distribución de versiones.

El informe de telemetría se divide en diferentes canales, cada uno con un tipo diferente de información. Una vez habilitada la telemetría, puede activar o desactivar los canales individuales.

Los siguientes son los cuatro canales diferentes:

basic -El valor predeterminado es on. Este canal proporciona la información básica sobre los clústeres, que incluye la información siguiente:
- La capacidad del clúster.
- Número de supervisores, gestores, OSD, MSD, pasarelas de objetos Ceph u otros daemons.
- La versión de software que se está utilizando actualmente.
- El número y los tipos de agrupaciones RADOS y sistemas de archivos Ceph.
- Los nombres de las opciones de configuración que se han cambiado desde su valor predeterminado (pero no sus valores).
crash -El valor predeterminado es on. Este canal proporciona información sobre los bloqueos de daemon, que incluye la información siguiente:
- El tipo de daemon.
- La versión del daemon.
- El sistema operativo, la distribución del sistema operativo y la versión del kernel.
- El rastreo de pila que identifica dónde se ha producido el bloqueo en el código Ceph.
device -El valor predeterminado es on. Este canal proporciona información sobre las métricas de dispositivo, que incluyen métricas SMART anonimizadas.
ident -El valor predeterminado es off. Este canal proporciona la información de identificación proporcionada por el usuario sobre el clúster como, por ejemplo, la descripción del clúster y la dirección de correo electrónico de contacto.
perf -El valor predeterminado es off. Este canal proporciona las diversas medidas de rendimiento del clúster, que se pueden utilizar para lo siguiente:
- Revelar el estado general del clúster.
- Identificar patrones de carga de trabajo.
- Resolución de problemas de latencia, regulación, gestión de memoria y otros problemas similares.
- Supervise el rendimiento del clúster por daemon.

Los datos de los que se informa no contienen datos confidenciales como, por ejemplo, nombres de agrupación, nombres de objeto, contenido de objeto, nombres de host o números de serie de dispositivo.

Contiene contadores y estadísticas sobre cómo se despliega el clúster, la versión de Ceph, la distribución de host y otros parámetros que ayudan al proyecto a comprender mejor la forma en que se utiliza Ceph.

Los datos son seguros y se envían a https://telemetry.ceph.com.

Habilitar la telemetría

Antes de habilitar los canales, asegúrese de que la telemetría sea on.

Habilite la telemetría.
```
ceph telemetry on
```

Habilitar e inhabilitar canales

Habilitar o inhabilitar canales individuales.

ceph telemetry enable channel basic
ceph telemetry enable channel crash
ceph telemetry enable channel device
ceph telemetry enable channel ident
ceph telemetry enable channel perf

ceph telemetry disable channel basic
ceph telemetry disable channel crash
ceph telemetry disable channel device
ceph telemetry disable channel ident
ceph telemetry disable channel perf

Habilitar o inhabilitar varios canales.

ceph telemetry enable channel basic crash device ident perf
ceph telemetry disable channel basic crash device ident perf

Habilitar o inhabilitar todos los canales juntos:

ceph telemetry enable channel all
ceph telemetry disable channel all

Informe de ejemplo

Para revisar los datos notificados en cualquier momento, genere un informe de ejemplo.
```
ceph telemetry show
```
Si la telemetría es off, obtenga una vista previa del informe de ejemplo.
```
ceph telemetry preview
```
Se tarda más en generar un informe de ejemplo para clústeres de almacenamiento con cientos de OSD o más.
Para proteger su privacidad, los informes de dispositivo se generan por separado, y los datos como el nombre de host y el número de serie del dispositivo se anonimizan. La telemetría de dispositivo se envía a un punto final diferente y no asocia los datos de dispositivo con un clúster determinado. Para ver el informe de dispositivo, ejecute el mandato siguiente.
```
ceph telemetry show-device
```
Si la telemetría es off, obtenga una vista previa del informe de dispositivo de ejemplo.
```
ceph telemetry preview-device
```
Obtenga una única salida de ambos informes con telemetría on.
```
ceph telemetry show-all
```
Obtenga una única salida de ambos informes con telemetría off.
```
ceph telemetry preview-all
```
Generar un informe de ejemplo por canal.
```
ceph telemetry show CHANNEL_NAME
```
Genere una vista previa del informe de ejemplo por canal.
```
ceph telemetry preview CHANNEL_NAME
```

Recopilaciones

Las colecciones son diferentes aspectos de los datos que se recopilan dentro de un canal.

Listar las colecciones.
```
ceph telemetry collection ls
```
Vea la diferencia entre las colecciones en las que está inscrito y las nuevas colecciones disponibles.
```
ceph telemetry diff
```

Inscríbase a las colecciones más recientes.

ceph telemetry on
ceph telemetry enable channel CHANNEL_NAME

Interval

El módulo compila y envía un nuevo informe cada 24 horas de forma predeterminada.

Ajuste el intervalo.

ceph config set mgr mgr/telemetry/interval INTERVAL

[ceph: root@host01 /]# ceph config set mgr mgr/telemetry/interval 72

En el ejemplo, el informe se genera cada tres días (72 horas).

Estado

Ver la configuración actual.
```
ceph telemetry status
```

Envío manual de telemetría

Enviar datos de telemetría de forma ad hoc.
```
ceph telemetry send
```
Si la telemetría está inhabilitada, añada --license sharing-1-0 al mandato ceph telemetry send .

Envío de telemetría a través de un proxy

Si el clúster no puede conectarse directamente al punto final de telemetría configurado, puede configurar un servidor proxy HTTP /HTTPs.

ceph config set mgr mgr/telemetry/proxy PROXY_URL

Por ejemplo:

[ceph: root@host01 /]# ceph config set mgr mgr/telemetry/proxy https://10.0.0.1:8080

Puede incluir el pase de usuario en el mandato.

[ceph: root@host01 /]# ceph config set mgr mgr/telemetry/proxy https://10.0.0.1:8080

Contacto y descripción

Opcional: añada un contacto y una descripción al informe.

ceph config set mgr mgr/telemetry/contact 'CONTACT_NAME'
ceph config set mgr mgr/telemetry/description 'DESCRIPTION'
ceph config set mgr mgr/telemetry/channel_ident true

[ceph: root@host01 /]# ceph config set mgr mgr/telemetry/contact 'John Doe < john.doe @ example.com >'
[ceph: root@host01 /]# ceph config set mgr mgr/telemetry/description 'Mi primer cluster Ceph'
[ceph: root@host01 /]# ceph config set mgr mgr/telemetry/channel_ident true

Si el distintivo ident está habilitado, sus detalles no se visualizan en el marcador.

Marcador

Participar en un marcador en el panel de control público.
```
[ceph: root@host01 /]# ceph config set mgr mgr/telemetry/leaderboard true
```
El marcador muestra información básica sobre el clúster de almacenamiento. Esta placa incluye la capacidad de almacenamiento total y el número de OSD.