Configurar el adaptador de Open Telemetry
En la vista de inicio, acceda a la pestaña Ajustes y seleccione Conexiones de servidor en el panel izquierdo.
Introduzca los parámetros siguientes en la ventana Open Telemetry:
Campo
Descripción
Activada/Desactivada
Activa/desactiva el adaptador.
Exponer datos sensibles
Activa/desactiva la exportación de datos sensibles, como el IP y el IMEI, al cliente.
Habilitar recopilación de datos de Prometheus
Habilita el servidor HTTP para los puntos finales y métricas de recopilación de datos de Prometheus.
Puerto Prometheus
Configura el puerto en el que el servidor HTTP estará a la escucha.
Esta opción solo es visible si Prometheus está activado.
Autenticación de Prometheus
Habilita la autenticación básica para las recopilaciones de datos de Prometheus.
Esta opción solo es visible si Prometheus está activado.
Nombre de usuario
Introduce el nombre de usuario que se utilizará al extraer datos.
Esta opción solo es visible si la autenticación de Prometheus está activada.
Contraseña
Introduce la contraseña que se utilizará durante la recopilación de datos. La contraseña se mostrará en texto sin cifrar.
Esta opción solo es visible si la autenticación de Prometheus está activada.
Habilitar envío push OTLP/HTTP
Habilita el exportador OTLP/HTTP para que comience a enviar actualizaciones periódicas.
URL de métricas OTLP
Introduce el punto final de métricas OTLP/HTTP al que el exportador deberá enviar los datos en formato protobuf.
Esta configuración solo es visible si OTLP está habilitado.
Intervalo de actualización
El intervalo de sondeo con el que el adaptador recabará datos de métricas de la herramienta o el controlador, así como el intervalo de actualización con el que el adaptador exportará dichos datos al punto final OTLP/HTTP.
El adaptador incluye el nombre del controlador, configurado en el campo Nombre de IAM, en los mensajes como nombre del servicio. Si el nombre de IAM está vacío, el nombre del servicio se exportará como px2system.
Métricas de información de Prometheus
La información estática del sistema se envía en forma de métricas de Open Telemetry. A continuación, los datos están disponibles en las etiquetas.
Métrico | Tipo | Unidad | Descripción |
|---|---|---|---|
px2system_device_info | manómetro | 1 | Metadatos estáticos de px2system exportados como una métrica *_infostyle con un valor constante de 1. |
cellular_enabled | manómetro | 1 | 1 si la conexión móvil está activada en la configuración del controlador; 0 si está presente pero desactivada. Solo se emite cuando hay conexión móvil. |
cellular_connection_info | manómetro | 1 | Solo se emite, con un valor constante de 1, cuando hay conexión móvil y está activada. |
cellular_up | manómetro | 1 | 1 si la última muestra de telemetría móvil es reciente y todos los valores son numéricos; en caso contrario, 0. Se emite cuando la conexión móvil está presente y activada (puede faltar alguna muestra); es cero si la conexión móvil no está conectada. |
cellular_signal_sample_age_seconds | manómetro | s | Antigüedad de la última muestra móvil, en segundos. -1 si no hay ninguna muestra disponible o si la muestra está obsoleta o no es válida. |
cellular_signal_rsrp_dbm | manómetro | dBm | Potencia de señal de referencia recibida. Se emite únicamente cuando cellular_signal_up == 1. |
cellular_signal_rsrq_db | manómetro | dB | Calidad de la señal de referencia recibida. Se emite únicamente cuando el teléfono móvil está presente, activado y conectado. |
cellular_signal_rssi_dbm | manómetro | dBm | Indicador de intensidad de la señal recibida. Se emite únicamente cuando el teléfono móvil está presente, activado y conectado. |
cellular_signal_snr_db | manómetro | dB | Relación señal-ruido. Se emite únicamente cuando el teléfono móvil está presente, activado y conectado. |
cellular_signal_tx_dbm | manómetro | dBm | Transmite potencia. Se emite únicamente cuando el teléfono móvil está presente, activado y conectado. |
wifi_enabled | manómetro | 1 | 1 si el cliente wifi está activado en la configuración del controlador; 0 si está presente pero desactivado. Solo se emite cuando está el cliente wifi. |
wifi_connection_info | manómetro | 1 | Solo se emite, con un valor constante de 1, cuando hay una red wifi disponible y está activada, y existe una muestra de wifi. |
wifi_up | manómetro | 1 | 1 si la última muestra de wifi es reciente y los valores son numéricos; en caso contrario, 0. Se emite cuando hay una red wifi disponible y está activada (puede que falte algún dato). Es cero si no hay conexión a la red wifi. |
wifi_signal_sample_age_seconds | manómetro | s | Antigüedad de la última muestra wifi, en segundos. -1 si no hay ninguna muestra disponible o si la muestra está obsoleta o no es válida. |
wifi_signal_rssi_dbm | manómetro | dBm | Indicador de intensidad de la señal recibida wifi. Se emite únicamente cuando el wifi está presente, activado y conectado. |
wifi_link_quality_percent | manómetro | % | Calidad de la conexión wifi. Se emite únicamente cuando el wifi está presente, activado y conectado. |
wifi_tx_bitrate_mbps | manómetro | Mbit/s | Velocidad máxima de transmisión negociada por wifi. Se emite únicamente cuando el wifi está presente, activado y conectado. |
wifi_rx_bitrate_mbps | manómetro | Mbit/s | Velocidad máxima de recepción negociada por wifi. Se emite únicamente cuando el wifi está presente, activado y conectado. |
Métrico | Etiqueta principal | Sensible | Notas |
|---|---|---|---|
px2system_device_info | service_name | no | El nombre de IAM configurado; si está vacío, se muestra como «px2system». |
px2system_device_info | tool_serial | no | Identificador de herramienta. Se emite cuando hay un identificador de herramienta disponible. |
px2system_device_info | tool_model | no | Identificador del modelo de la herramienta. Se emite cuando hay un identificador de herramienta disponible. |
cellular_connection_info | tecnología | no | Valores de ejemplo: "4G", "5G". Se emite cuando la red móvil está activada. |
cellular_connection_info | pci | no | ID de celda física. Se emite cuando está disponible desde el módem. |
cellular_connection_info | carrier_name | no | Nombre del encargado/operador. Se emite cuando está disponible desde el módem. |
cellular_connection_info | carrier_mcc | no | Código de país para móviles. Se emite cuando está disponible desde el módem. |
cellular_connection_info | carrier_mnc | no | Código de red para móviles. Se emite cuando está disponible desde el módem. |
cellular_connection_info | apn | sí | Nombre del punto de acceso configurado; restringido por la propiedad exposeSensitiveData. |
cellular_connection_info | ip_address | sí | Dirección IP utilizada por el módem móvil; restringida por el riesgo de exposición de datos sensibles. |
cellular_connection_info | imei | sí | Identidad Internacional de Equipo Móvil (IMEI) del módem; restringido por el riesgo de exposición de datos sensible |
cellular_connection_info | sim_iccid | sí | Número de serie de la tarjeta SIM; solo si está presente; sujeto a restricciones por exposición de datos sensibles. |
cellular_connection_info | frequency_band | no | Banda de frecuencia utilizada por el módem móvil. Se emite cuando está disponible desde el módem. |
cellular_connection_info | Ancho de banda | no | Ancho de banda utilizado por el módem móvil. Se emite cuando está disponible desde el módem. |
cellular_connection_info | mtu | no | Unidad de transición máxima. Se emite cuando está disponible desde el módem. |
cellular_connection_info | imsi | sí | SIM (Identidad Internacional de Abonado Móvil); amenazada por la exposición de datos sensibles. |
wifi_connection_info | canal | no | Canal wifi. Se emite cuando está disponible desde el sistema. |
wifi_connection_info | ssid | sí | El nombre único de la red wifi; protegido para evitar la exposición de datos confidenciales. |
wifi_connection_info | bssid | sí | Una dirección MAC única para cada punto de acceso; restringida por la exposición de datos sensibles. |
wifi_connection_info | mac_address | sí | Dirección MAC de la tarjeta wifi; restringida por el riesgo de exposición de datos sensibles. |
wifi_connection_info | ipv4 | sí | Dirección IP utilizada por el wifi; restringida por el riesgo de exposición de datos sensibles. |
Métricas de información de OTLP/HTTP
Métrico | Unidad | Descripción |
|---|---|---|
cellular.enabled | 1 | 1 si la conexión móvil está activada en la configuración del controlador; de lo contrario, 0. Solo se emite cuando hay conexión móvil. |
cellular.up | 1 | 1 si la última muestra de conexión móvil es numérica; en caso contrario, 0. Se emite cuando la conexión móvil está presente y activado; puede emitirse como 0 si la muestra falta o no es válida, por lo que no hay conexión. |
cellular.signal.sample_age | s | Antigüedad de la última muestra móvil, en segundos. -1 si falta la muestra o no es válida. |
cellular.signal.rsrp | dBm | Potencia de señal de referencia recibida. Se emite únicamente cuando el valor de la muestra es numérico y el dispositivo móvil está presente, activado y conectado. |
cellular.signal.rsrq | dB | Calidad de la señal de referencia recibida. Se emite únicamente cuando el valor de la muestra es numérico y el dispositivo móvil está presente, activado y conectado. |
cellular.signal.rssi | dBm | Indicador de intensidad de la señal recibida. Se emite únicamente cuando el valor de la muestra es numérico y el dispositivo móvil está presente, activado y conectado. |
cellular.signal.snr | dB | Relación señal-ruido. Se emite únicamente cuando el valor de la muestra es numérico y el dispositivo móvil está presente, activado y conectado. |
cellular.signal.tx_power | dBm | Transmite potencia. Se emite únicamente cuando el valor de la muestra es numérico y el dispositivo móvil está presente, activado y conectado. |
wifi.enabled | 1 | 1 si el cliente wifi está activado en la configuración del controlador; de lo contrario, 0. Solo se emite cuando está el cliente wifi. |
wifi.up | 1 | 1 si la última muestra de wifi es numérica; en caso contrario, 0. Se emite cuando el wifi está presente y activado; puede emitirse como 0 si la muestra falta o no es válida, por lo que no hay conexión. |
wifi.signal.sample_age | s | Antigüedad de la última muestra wifi, en segundos. -1 si falta la muestra o no es válida. |
wifi.signal.rssi | dBm | Indicador de intensidad de la señal recibida wifi. Se emite únicamente cuando el valor de la muestra es numérico y el wifi está presente, activado y conectado. |
wifi.link.quality | % | Calidad de la conexión wifi. Se emite únicamente cuando el valor de la muestra es numérico y el wifi está presente, activado y conectado. |
wifi.link.tx_bitrate | Mbit/s | Velocidad máxima de transmisión negociada por wifi. Se emite únicamente cuando el valor de la muestra es numérico y el wifi está presente, activado y conectado. |
wifi.link.rx_bitrate | Mbit/s | Velocidad máxima de recepción negociada por wifi. Se emite únicamente cuando el valor de la muestra es numérico y el wifi está presente, activado y conectado. |
Tecla | Sensible | Notas |
|---|---|---|
service.name | no | El nombre de IAM configurado; si está vacío, se muestra como «px2system». |
tool.serial_number | no | Número de serie de la herramienta. Se muestra únicamente cuando hay al menos un dominio presente y activado, y la serie Herramientas está disponible. |
tool.model | no | Modelo de herramienta. Se muestra únicamente cuando hay al menos un dominio presente y activado, y el modelo Herramienta está disponible. |
cellular.present | no | Devuelve «true» cuando hay conexión móvil (aunque esté desactivada). Devuelve «false» si no hay conexión móvil en el sistema. |
cellular.radio.tech | no | Valores de ejemplo: "4G", "5G". Se emite cuando está disponible y la red móvil está activada. |
cellular.carrier.name | no | Nombre del encargado/operador. Se emite cuando está disponible y la red móvil está activada. |
cellular.carrier.mcc | no | Código de país para móviles. Se emite cuando está disponible y la red móvil está activada. |
cellular.carrier.mnc | no | Código de red para móviles. Se emite cuando está disponible y la red móvil está activada. |
cellular.frequency.band | no | Banda de frecuencia de telefonía móvil. Se emite cuando está disponible y la red móvil está activada. |
cellular.frequency.bandwidth | no | Ancho de banda móvil. Se emite cuando está disponible y la red móvil está activada. |
cellular.link.mtu | no | Unidad de transición máxima. Se emite cuando está disponible y la red móvil está activada. |
cellular.pci | no | Identidad de celda física. Se emite cuando está disponible y la red móvil está activada. |
cellular.ip | sí | Dirección IP del módem móvil. Se emite cuando la red móvil está activada. Limitado por la exposición de datos sensibles. |
cellular.apn | sí | Nombre del punto de acceso configurado. Se emite cuando la red móvil está activada. Limitado por la exposición de datos sensibles. |
cellular.imei | sí | Identidad Internacional de Equipo Móvil (IMEI) del módem. Se emite cuando la red móvil está activada. Limitado por la exposición de datos sensibles. |
cellular.imsi | sí | SIM: Identidad Internacional de Abonado Móvil. Se emite cuando la red móvil está activada. Limitado por la exposición de datos sensibles. |
cellular.sim.iccid | sí | Número de serie de SIM. Solo cuando está presente; se emite cuando el modo celular está activado. Limitado por la exposición de datos sensibles. |
wifi.present | no | Devuelve «true» cuando hay un cliente wifi presente (aunque esté desactivado). Devuelve «false» si no hay wifi en el sistema. |
wifi.channel | no | Canal wifi del sistema. Se emite cuando hay una red wifi disponible y está activada. |
wifi.ssid | sí | El nombre único de la red wifi. Se emite cuando hay una red wifi disponible y está activada. Limitado por la exposición de datos sensibles. |
wifi.bssid | sí | Una dirección MAC única para cada punto de acceso. Se emite cuando hay una red wifi disponible y está activada. Limitado por la exposición de datos sensibles. |
wifi.mac_address | sí | Dirección MAC de la tarjeta wifi. Se emite cuando hay una red wifi disponible y está activada. Limitado por la exposición de datos sensibles. |
wifi.ipv4 | sí | Dirección IP utilizada por la red wifi. Se emite cuando hay una red wifi disponible y está activada. Limitado por la exposición de datos sensibles. |
Autenticación de Prometheus
Cuando la autenticación Prometheus está habilitada en OpenTelemetry, los clientes deben enviar el nombre de usuario y la contraseña correctos en el encabezado Autorización de la solicitud GET (scrape). Si faltan las credenciales o son incorrectas, el servidor responde con el código 401 No autorizado. La autenticación tiene prioridad: el servidor devuelve el código 401 incluso si la solicitud utiliza una ruta incorrecta. Si las credenciales son correctas, el servidor responde como si la autenticación estuviera desactivada: 200 con el scrape para una ruta correcta, o 404 No encontrado para una ruta incorrecta.
La contraseña se almacena y se muestra en texto sin cifrar en la ventana de OpenTelemetry como una decisión deliberada en favor de la usabilidad. Esta decisión está pensada para entornos operativos controlados en los que el acceso a la interfaz de usuario está restringido. Se espera que los usuarios apliquen los controles de acceso adecuados a la interfaz de gestión.
Gestión de errores de Prometheus
Si un cliente realiza un scraping en cualquier ruta que no sea /metrics, el servidor devuelve un error HTTP 404. Si la autenticación está habilitada, consulta la sección Autenticación para conocer la gestión de errores. Si Prometheus no está habilitado, la solicitud del cliente agota el tiempo de espera.
Gestión de errores OTLP/HTTP
El exportador utiliza una conexión persistente (keep-alive) con el colector OTEL. Abre la conexión de forma diferida en el primer envío y reutiliza el socket para los envíos posteriores. Si la conexión falla, intenta reutilizar el socket siempre que sea posible.
Si la exportación no consigue conectarse, el adaptador aplica una política de retroceso con una variación de ±25 % para los reintentos consecutivos. El tiempo máximo de retroceso es de 30 segundos. Tras 10 fallos consecutivos, el adaptador espera 5 minutos antes de realizar el siguiente intento.
Fallos en las respuestas HTTP que se pueden reintentar y que utilizan la política de retroceso:
No se puede conectar al punto final.
Error de envío / error de lectura (la conexión se cierra y se vuelve a intentar).
Estado de la respuesta HTTP:
408 (tiempo de espera agotado)
429 (limitación de tráfico)
Cualquier código 5xx (errores del servidor).
Fallos no recuperables (pausa hasta que cambie la configuración):
Cualquier respuesta HTTP 4xx.
URL de métricas no válida.
Se ha configurado https:// (TLS no compatible)
Si no existe ninguna muestra de telemetría (por ejemplo, al iniciar el sistema), el adaptador no lo considera un error y no aplica la política de retroceso.
