Configurer l'adaptateur Open Telemetry
Sur la page d'accueil, aller sur l’onglet Réglages et sélectionner Connexions serveur sur le panneau gauche.
Dans la fenêtre Open Telemetry, configurer les paramètres suivants :
Champ
Description
Marche/Arrêt
Active/désactive l'adaptateur.
Rendre disponible les données sensibles
Active/désactive l'exportation de données sensibles, telles que l'adresse IP et l'IMEI, vers le client.
Activer la collecte de données par Prometheus
Active le serveur HTTP pour le point de terminaison de collecte de données /metrics par Prometheus.
Port Prometheus
Configure le port sur lequel le serveur HTTP sera à l'écoute.
Ce paramètre n'est visible que si Prometheus est activé.
Authentification Prometheus
Active l'authentification de base pour les collectes de données par Prometheus.
Ce paramètre n'est visible que si Prometheus est activé.
Nom d’utilisateur
Saisir le nom d'utilisateur à utiliser pour la collecte de données.
Ce paramètre n'est visible que si l'authentification Prometheus est activée.
Mot de passe
Saisir le mot de passe à utiliser pour la collecte de données. Le mot de passe sera affiché en clair.
Ce paramètre n'est visible que si l'authentification Prometheus est activée.
Activer le transfert OTLP/HTTP
Permet à l'exportateur OTLP/HTTP de commencer à envoyer des mises à jour périodiques.
URL des données OTLP
Saisir le point de terminaison des données OTLP/HTTP auquel l'exportateur doit envoyer les données au format Protobuf.
Ce paramètre n'est visible que si OTLP est activé.
Intervalle de mise à jour
L'intervalle d'interrogation pendant lequel l'adaptateur interroge l'outil/le contrôleur pour obtenir les données, ainsi que l'intervalle de mise à jour pendant lequel l'adaptateur exporte ces données vers le point de terminaison OTLP/HTTP.
L'adaptateur associe le nom du contrôleur, configuré sous Nom IAM, aux messages en tant que nom de service. Si le nom IAM est vide, le nom du service sera exporté sous la forme px2system.
Données d’informations Prometheus
Les informations statiques sur le système sont transmises sous forme de données d’informations Open Telemetry. Les données sont alors disponibles dans les étiquettes.
Donnée | Type | Unité | Description |
|---|---|---|---|
px2system_device_info | jauge | 1 | Métadonnées statiques px2system exportées sous la forme de donnée *_infostyle dont la valeur est constante et égale à 1. |
cellular_enabled | jauge | 1 | 1 si la fonction cellulaire est activée dans la configuration du contrôleur ; 0 si elle est présente mais désactivée. Émis uniquement lorsque le réseau cellulaire est présent. |
cellular_connection_info | jauge | 1 | N'est émis qu'avec une valeur constante de 1 lorsque le réseau cellulaire est présent et activé. |
cellular_up | jauge | 1 | 1 si le dernier échantillon de télémétrie cellulaire est récent et que toutes les valeurs sont numériques ; sinon, 0. Émis lorsque la connexion cellulaire est présente et activée (la valeur peut être manquante) ; vaut zéro si le réseau cellulaire n'est pas connecté. |
cellular_signal_sample_age_seconds | jauge | s | Âge du dernier échantillon cellulaire, en secondes. -1 si aucun échantillon n'est disponible ou si l'échantillon est périmé ou non valide. |
cellular_signal_rsrp_dbm | jauge | dBm | Puissance du signal de référence reçu. Émis uniquement lorsque cellular_signal_up==1. |
cellular_signal_rsrq_db | jauge | dB | Qualité du signal de référence reçu. Émis uniquement lorsque le réseau cellulaire est présent, activé et connecté. |
cellular_signal_rssi_dbm | jauge | dBm | Indicateur de puissance du signal reçu. Émis uniquement lorsque le réseau cellulaire est présent, activé et connecté. |
cellular_signal_snr_db | jauge | dB | Rapport signal/bruit. Émis uniquement lorsque le réseau cellulaire est présent, activé et connecté. |
cellular_signal_tx_dbm | jauge | dBm | Puissance d'émission. Émis uniquement lorsque le réseau cellulaire est présent, activé et connecté. |
wifi_enabled | jauge | 1 | 1 si le client Wi-Fi est activé dans la configuration du contrôleur ; 0 s'il est présent mais désactivé. Émis uniquement lorsque le client Wi-Fi est présent. |
wifi_connection_info | jauge | 1 | N'est émis qu'avec une valeur constante de 1 lorsque le Wi-Fi est présent et activé, et qu'un échantillon Wi-Fi existe. |
wifi_up | jauge | 1 | 1 si le dernier échantillon Wi-Fi est récent et que les valeurs sont numériques ; sinon, 0. Émis lorsque le Wi-Fi est disponible et activé (l'échantillon peut manquer). Zéro si le Wi-Fi n'est pas connecté. |
wifi_signal_sample_age_seconds | jauge | s | Âge du dernier échantillon Wi-Fi, en secondes. -1 si aucun échantillon n'est disponible ou si l'échantillon est périmé ou non valide. |
wifi_signal_rssi_dbm | jauge | dBm | Indicateur de puissance du signal Wi-Fi reçu. Émis uniquement lorsque le Wi-Fi est présent, activé et connecté. |
wifi_link_quality_percent | jauge | % | Qualité de la connexion Wi-Fi. Émis uniquement lorsque le Wi-Fi est présent, activé et connecté. |
wifi_tx_bitrate_mbps | jauge | Mbit/s | Débit de transmission TX maximal Wi-Fi négocié. Émis uniquement lorsque le Wi-Fi est présent, activé et connecté. |
wifi_rx_bitrate_mbps | jauge | Mbit/s | Débit de transmission RX maximal Wi-Fi négocié. Émis uniquement lorsque le Wi-Fi est présent, activé et connecté. |
Donnée | Étiquette | Sensible | Notes |
|---|---|---|---|
px2system_device_info | service_name | non | Le nom IAM configuré ; s'il est vide, émis sous la forme « px2system ». |
px2system_device_info | tool_serial | non | Identifiant de l'outil. Émis lorsque l'identifiant de l'outil est disponible. |
px2system_device_info | tool_model | non | Identifiant du modèle d'outil. Émis lorsque l'identifiant de l'outil est disponible. |
cellular_connection_info | technologie | non | Exemples de valeurs : « 4G », « 5G ». Émis lorsque le réseau cellulaire est activé. |
cellular_connection_info | pci | non | Identifiant physique de la cellule. Émis par le modem lorsqu'il est disponible. |
cellular_connection_info | carrier_name | non | Nom du fournisseur / de l'opérateur. Émis par le modem lorsqu'il est disponible. |
cellular_connection_info | carrier_mcc | non | Indicatif national de téléphonie mobile. Émis par le modem lorsqu'il est disponible. |
cellular_connection_info | carrier_mnc | non | Code du réseau mobile. Émis par le modem lorsqu'il est disponible. |
cellular_connection_info | apn | oui | Nom du point d'accès configuré ; restreint par exposeSensitiveData. |
cellular_connection_info | ip_address | oui | Adresse IP utilisée par le modem cellulaire ; restreint en raison de la divulgation de données sensibles. |
cellular_connection_info | imei | oui | Identifiant international d'appareil mobile (IMEI) du modem ; restreint en raison du risque de divulgation de données sensibles. |
cellular_connection_info | sim_iccid | oui | Numéro de série SIM ; uniquement s'il est présent ; restreint en raison du risque de divulgation de données sensibles. |
cellular_connection_info | frequency_band | non | Bande de fréquences utilisée par le modem cellulaire. Émis par le modem lorsqu'il est disponible. |
cellular_connection_info | bande passante | non | Bande passante utilisée depuis le modem cellulaire. Émis par le modem lorsqu'il est disponible. |
cellular_connection_info | mtu | non | Unité de transition maximum. Émis par le modem lorsqu'il est disponible. |
cellular_connection_info | imsi | oui | Identité internationale de l'abonné mobile (SIM) ; restreint en raison du risque de divulgation de données sensibles. |
wifi_connection_info | canal | non | Canal Wi-Fi. Émis lorsqu'il est disponible depuis le système. |
wifi_connection_info | ssid | oui | Le nom unique du réseau Wi-Fi ; restreint en raison du risque de divulgation de données sensibles. |
wifi_connection_info | bssid | oui | Le MAC unique pour le point d'accès unique ; restreint en raison du risque de divulgation de données sensibles. |
wifi_connection_info | mac_address | oui | Adresse MAC pour la carte Wi-Fi ; restreint en raison de la divulgation de données sensibles. |
wifi_connection_info | ipv4 | oui | Adresse IP utilisée par le WiFi ; restreint en raison de la divulgation de données sensibles. |
Données d'informations OTLP/HTTP
Donnée | Unité | Description |
|---|---|---|
cellular.enabled | 1 | 1 si la fonction cellulaire est activée dans la configuration du contrôleur ; sinon 0. Émis uniquement lorsque le réseau cellulaire est présent. |
cellular.up | 1 | 1 si le dernier échantillon cellulaire est numérique ; sinon, 0. Émis lorsque le réseau cellulaire est présent et activé ; peut prendre la valeur 0 si l'échantillon est manquant / non valide, et donc non connecté. |
cellular.signal.sample_age | s | Âge du dernier échantillon cellulaire, en secondes. -1 si l'échantillon est manquant / non valide. |
cellular.signal.rsrp | dBm | Puissance du signal de référence reçu. Émis uniquement lorsque l'échantillon est numérique et que le réseau cellulaire est présent, activé et connecté. |
cellular.signal.rsrq | dB | Qualité du signal de référence reçu. Émis uniquement lorsque l'échantillon est numérique et que le réseau cellulaire est présent, activé et connecté. |
cellular.signal.rssi | dBm | Indicateur de puissance du signal reçu. Émis uniquement lorsque l'échantillon est numérique et que le réseau cellulaire est présent, activé et connecté. |
cellular.signal.snr | dB | Rapport signal/bruit. Émis uniquement lorsque l'échantillon est numérique et que le réseau cellulaire est présent, activé et connecté. |
cellular.signal.tx_power | dBm | Puissance d'émission. Émis uniquement lorsque l'échantillon est numérique et que le réseau cellulaire est présent, activé et connecté. |
wifi.enabled | 1 | 1 si le client Wi-Fi est activée dans la configuration du contrôleur ; sinon 0. Émis uniquement lorsque le client Wi-Fi est présent. |
wifi.up | 1 | 1 si le dernier échantillon Wi-Fi est numérique ; sinon 0. Émis lorsque le Wi-Fi est présent et activé ; peut prendre la valeur 0 si l'échantillon est manquant / non valide, et donc non connecté. |
wifi.signal.sample_age | s | Âge du dernier échantillon Wi-Fi, en secondes. -1 si l'échantillon est manquant / non valide. |
wifi.signal.rssi | dBm | Indicateur de puissance du signal Wi-Fi reçu. Émis uniquement lorsque l'échantillon est numérique et que le Wi-Fi est présent, activé et connecté. |
wifi.link.quality | % | Qualité de la connexion Wi-Fi. Émis uniquement lorsque l'échantillon est numérique et que le Wi-Fi est présent, activé et connecté. |
wifi.link.tx_bitrate | Mbit/s | Débit de transmission TX maximal Wi-Fi négocié. Émis uniquement lorsque l'échantillon est numérique et que le Wi-Fi est présent, activé et connecté. |
wifi.link.rx_bitrate | Mbit/s | Débit de transmission RX maximal Wi-Fi négocié. Émis uniquement lorsque l'échantillon est numérique et que le Wi-Fi est présent, activé et connecté. |
Code | Sensible | Notes |
|---|---|---|
service.name | non | Le nom IAM configuré ; s'il est vide, émis sous la forme « px2system ». |
tool.serial_number | non | Numéro de série de l'outil. Émis uniquement lorsqu'au moins un domaine est présent et activé, et que le numéro de série de l'outil est disponible. |
tool.model | non | Modèle de l'outil. Émis uniquement lorsqu'au moins un domaine est présent et activé, et que le modèle de l'outil est disponible. |
cellular.present | non | Émis comme « vrai » lorsque le réseau cellulaire est présent (même s'il est désactivé). Émis comme « faux » si le réseau cellulaire n'est pas présent dans le système. |
cellular.radio.tech | non | Exemples de valeurs : « 4G », « 5G ». Émis lorsque disponible et que le réseau cellulaire est activé. |
cellular.carrier.name | non | Nom du fournisseur / de l'opérateur. Émis lorsque disponible et que le réseau cellulaire est activé. |
cellular.carrier.mcc | non | Indicatif national de téléphonie mobile. Émis lorsque disponible et que le réseau cellulaire est activé. |
cellular.carrier.mnc | non | Code du réseau mobile. Émis lorsque disponible et que le réseau cellulaire est activé. |
cellular.frequency.band | non | Bande de fréquences du réseau cellulaire. Émis lorsque disponible et que le réseau cellulaire est activé. |
cellular.frequency.bandwidth | non | Bande passante cellulaire. Émis lorsque disponible et que le réseau cellulaire est activé. |
cellular.link.mtu | non | Unité de transition maximum. Émis lorsque disponible et que le réseau cellulaire est activé. |
cellular.pci | non | Identifiant physique de la cellule. Émis lorsque disponible et que le réseau cellulaire est activé. |
cellular.ip | oui | Adresse IP du modem cellulaire. Émis lorsque le réseau cellulaire est activé. Restreint en raison de la divulgation de données sensibles. |
cellular.apn | oui | Nom du point d'accès configuré. Émis lorsque le réseau cellulaire est activé. Restreint en raison de la divulgation de données sensibles. |
cellular.imei | oui | Identifiant international d'appareil mobile (IMEI) du modem. Émis lorsque le réseau cellulaire est activé. Restreint en raison de la divulgation de données sensibles. |
cellular.imsi | oui | Identité internationale de l'abonné mobile (SIM). Émis lorsque le réseau cellulaire est activé. Restreint en raison de la divulgation de données sensibles. |
cellular.sim.iccid | oui | Numéro de série SIM. Uniquement si présent ; émis lorsque le réseau cellulaire est activé. Restreint en raison de la divulgation de données sensibles. |
wifi.present | non | Émis comme « vrai » lorsque le client Wi-Fi est présent (même s'il est désactivé). Émis comme « faux » si le Wi-Fi n'est pas présent dans le système. |
wifi.channel | non | Canal Wi-Fi pour le système. Émis lorsque le Wi-Fi est présent et activé. |
wifi.ssid | oui | Le nom unique du réseau Wi-Fi. Émis lorsque le Wi-Fi est présent et activé. Restreint en raison de la divulgation de données sensibles. |
wifi.bssid | oui | Le MAC unique pour le point d'accès unique. Émis lorsque le Wi-Fi est présent et activé. Restreint en raison de la divulgation de données sensibles. |
wifi.mac_address | oui | Adresse MAC de la carte Wi-Fi. Émis lorsque le Wi-Fi est présent et activé. Restreint en raison de la divulgation de données sensibles. |
wifi.ipv4 | oui | Adresse IP utilisée par le Wi-Fi. Émis lorsque le Wi-Fi est présent et activé. Restreint en raison de la divulgation de données sensibles. |
Authentification Prometheus
Lorsque l'authentification Prometheus est activée dans OpenTelemetry, les clients doivent envoyer le nom d'utilisateur et le mot de passe corrects dans l'en-tête Autorisation de la requête GET (collecte de données). Si les identifiants sont manquants ou erronés, le serveur renvoie un code d'erreur 401 Non autorisé. L'autorisation est prioritaire : le serveur renvoie un code 401 même si la requête utilise un chemin incorrect. Si les identifiants sont corrects, le serveur répond comme si l'authentification était désactivée : 200 avec la collecte de données correspondant à un chemin correct, ou 404 Non trouvé pour un chemin incorrect.
Le mot de passe est enregistré et affiché en clair dans la fenêtre OpenTelemetry, ce qui constitue un compromis délibéré en matière d'ergonomie. Cette décision s'adresse aux environnements opérationnels contrôlés dans lesquels l'accès à l'interface utilisateur est restreint. Les utilisateurs sont tenus de mettre en place des contrôles de l'accès appropriés pour l'interface de gestion.
Gestion des erreurs Prometheus
Si un client tente d'accéder à un chemin d'accès autre que /metrics, le serveur renvoie une erreur HTTP 404. Si l'authentification est activée, consulter la section Authentification pour en savoir plus sur la gestion des erreurs. Si Prometheus n'est pas activé, la requête du client expire.
Gestion des erreurs OTLP/HTTP
L'exportateur utilise une connexion persistante (keep-alive) avec le collecteur OTEL. Il établit la connexion de manière différée lors du premier transfert et réutilise le socket pour les transferts suivants. Si la connexion échoue, le programme tente de réutiliser le socket lorsque cela est possible.
Si l'exportation ne parvient pas à se connecter, l'adaptateur utilise une politique d'attente avec une variation de ±25 % pour les tentatives successives. Le délai d'attente est limité à 30 secondes. Après 10 échecs consécutifs, l'adaptateur attend 5 minutes avant de faire une nouvelle tentative.
Échecs de réponse HTTP récupérables qui utilisent la politique d'attente :
Connexion au point de terminaison impossible.
Échec de l'envoi / échec de la lecture (la connexion est fermée et une nouvelle tentative est effectuée).
État de la réponse HTTP :
408 (délai d'expiration)
429 (limitation)
Tout 5xx (erreurs de serveur).
Échecs non récupérables (pause jusqu'à ce que la configuration change) :
Toute réponse HTTP 4xx.
URL des données non valides.
https:// configuré (incompatible TLS)
S'il n'existe aucun échantillon de télémétrie (par exemple, au démarrage), l'adaptateur ne considère pas cela comme un échec et n'applique pas la politique d'attente.
