Jaeger (jaeger)

Reçoit les traces OTLP du collecteur, les stocke en mémoire, dans OpenSearch ou dans l'Elasticsearch du client et sert l'interface et l'API de requête.

Généré depuis catalog/services/jaeger.yaml : ne pas modifier à la main.

Résumé

Version	2.22.0
Usage	installer et configurer
Couche	infrastructure (présentée à part)
Catégorie	Observabilité
Méthodes d'installation	binary, podman
Connexion externe	non
Réservé au bac à sable	non

Licence

Identifiant SPDX	Apache-2.0
Politique de licence	licence socle (MIT ou Apache-2.0)
Exception de licence	-
Composant de la plateforme	jaeger

Paquets et artefacts

Un paquet que publie le projet du service (son image, son archive binaire, son paquet Python ou système) porte la licence du service ; un paquet tiers porte la licence écrite sur sa ligne, lue dans les métadonnées officielles du projet amont.

Type	Paquet	Version	Licence	Détails
image de conteneur	docker.io/jaegertracing/jaeger	2.22.0	Apache-2.0	clé d'image jaeger, utilisée par jaeger, condensé sha256:836b967b5abcf1f7758066aa6b348619267a2f1459f72d472840570f9bd88a17
archive binaire	jaeger-2.22.0-linux-amd64.tar.gz	2.22.0	Apache-2.0	https://github.com/jaegertracing/jaeger/releases/download/v2.22.0/jaeger-2.22.0-linux-amd64.tar.gz, x86_64, somme de contrôle sha256

Les images sont épinglées par étiquette dans le descripteur, et par condensé (digest) quand le descripteur en déclare un (le bundle hors ligne refuse alors une image téléchargée qui ne le porte pas) ; le condensé est enregistré dans le miroir du Manager à l'import du bundle hors ligne, et chaque téléchargement ou chargement est vérifié par rapport à lui.

Systèmes et architectures pris en charge

Méthode	Systèmes d'exploitation	Architectures
binary	famille RHEL (dnf), famille Debian (apt), Arch Linux (pacman)	x86_64 (architecture des artefacts du descripteur)
podman	famille RHEL (dnf), famille Debian (apt), Arch Linux (pacman)	x86_64, aarch64 (non restreintes par le descripteur)

Systèmes hôtes certifiés : RHEL 8/9/10, Rocky Linux 8/9/10, AlmaLinux 8/9/10, Oracle Linux 8/9, CentOS Stream 9/10, Ubuntu 22.04/24.04, Debian 12, Arch Linux (rolling). Le contrôle préalable des hôtes accepte ces systèmes (une autre version d'une famille connue donne un avertissement, une version en fin de vie est refusée) et les architectures x86_64 et aarch64.

Prérequis

Hôte

Le descripteur ne déclare aucun contrôle préalable de l'hôte.

Réseau et ports

Composant	Nom du port	Port	Ouvert dans le pare-feu de l'hôte
jaeger	otlp_grpc	4417/tcp	oui
jaeger	query	16686/tcp	oui
jaeger	metrics	8889/tcp	oui
jaeger	health	13134/tcp	non

Services et connexions nécessaires

• opensearch : opensearch (facultative).
• elasticsearch : elasticsearch (facultative).

Détail et résolution : voir Dépendances.

Méthodes et modes d'installation

Méthode	Défaut	Ce que la méthode utilise
binary	oui	les archives binaires du descripteur, décompressées dans le répertoire du service
podman	-	les images de conteneur du descripteur, exécutées par Podman sous systemd

Composants

Composant	Type	Méthodes d'installation	Ports
Jaeger (jaeger)	maître	binary, podman	4417/tcp, 16686/tcp, 8889/tcp, 13134/tcp

Unique (single) (par défaut)

Un processus Jaeger : collecteur, stockage et requête.

Ce que le mode déploie :

Composant	Placement
jaeger	min 1, max 1

Répliqué (replicated)

Processus Jaeger sans état partageant le stockage OpenSearch.

Ce que le mode déploie :

Composant	Placement
jaeger	min 2, recommandé 2

Installer ce service

L'assistant d'installation du Navin Manager planifie, valide et exécute l'installation ; il faut la permission services:install sur le cluster.

1. Ouvrez l'assistant. Dans Clusters, choisissez l'action de ligne Installer des services du cluster cible. L'assistant s'ouvre sur sa première étape, Service.

2. Choisissez le service. À l'étape Service, sélectionnez Jaeger. La carte affiche la licence Apache-2.0 et les dépendances dont l'installation a besoin. Choisissez la Méthode parmi binary, podman (par défaut binary).

3. Choisissez les hôtes et le mode. À l'étape Hôtes, cochez les hôtes, puis choisissez le Mode : single (par défaut), replicated. Chaque mode déploie les composants listés dans Méthodes et modes d'installation.

4. Liez les dépendances. À l'étape Liaisons, choisissez pour chaque dépendance (opensearch, elasticsearch) Installer avec la plateforme ou Utiliser une connexion existante ; une dépendance facultative peut rester sur Aucune liaison.

5. Configurez. À l'étape Configuration, relisez les paramètres (voir Paramètres de configuration). Les mots de passe laissés vides avec une valeur générée par défaut sont générés et scellés par le Manager.

6. Relisez et installez. À l'étape Installation, le Manager valide le plan et affiche l'ordre d'installation ; quand il indique « Le plan est valide. Prêt pour l'installation. », choisissez Installer. Un mode hautement disponible n'est installé que si ses contrôles HA réussissent.

7. Vérifiez. L'opération se termine quand les contrôles de santé de chaque instance réussissent (voir Contrôles de santé) ; le service apparaît alors en marche dans Services.

Haute disponibilité

Cluster	réplicas (replication)
Haute disponibilité	externe (external)
Bascule	répartiteur (load-balancer)
Réplication	stockage partagé (shared-store)
Quorum	aucun (none)
Découverte	aucun (none)
Point d'entrée	répartiteur (load-balancer)
Documentation officielle	https://www.jaegertracing.io/docs/2.22/storage/

Prérequis

Prérequis	Doit être hautement disponible	Modes	Description
opensearch	oui	modes de niveau ha ou cluster	OpenSearch hautement disponible partagé par toutes les instances ; le stockage en mémoire ne se partage pas.

Topologie par mode

Modes	Niveau le plus haut du catalogue	Répartition	Composant du quorum	Domaines de panne	Description
single	autonome (standalone)	unique (single)	-	1	Un processus ; sans la liaison OpenSearch les traces restent en mémoire.
replicated	ha (ha)	actif-actif (active-active)	-	2	Processus sans état partageant le stockage OpenSearch, derrière le répartiteur.

Paramètres de configuration

Général

Paramètre	Type	Défaut	Valeurs permises	Obligatoire	Secret	Redémarrage	Description
Port OTLP gRPC (otlp_grpc_port)	port	4417	-	non	non	non	Port du récepteur OTLP gRPC (le collecteur du même hôte garde 4317).
Port de requête (query_port)	port	16686	-	non	non	non	Port de l'interface et de l'API de requête.
Port des métriques (metrics_port)	port	8889	-	non	non	non	Port des métriques propres à Jaeger.
Port de santé (health_port)	port	13134	-	non	non	non	Port de l'extension de contrôle de santé.
TLS (tls_enabled)	bool	false	-	non	non	oui	Servir le récepteur OTLP, l'interface et l'API de requête (HTTP et gRPC) et les métriques en TLS avec un certificat émis par l'autorité de la console.
Port interne des métriques (self_metrics_port)	port	4419	-	non	non	non	Port de la boucle locale qui reçoit les métriques propres à Jaeger quand TLS est activé, avant de les servir en TLS sur le port des métriques (le lecteur Prometheus intégré n'a pas de TLS). (avancé)
Traces en mémoire (memory_max_traces)	int	100000	min 1000, max 10000000	non	non	non	Traces gardées par le stockage en mémoire (sans OpenSearch ni Elasticsearch).

Dépendances

Pour chaque dépendance active, le Manager prend la première solution parmi : la liaison choisie dans l'assistant ; un service de la même installation qui la fournit ; un service déjà installé dans le cluster ; la seule connexion du type attendu. Sinon, une dépendance facultative reste non liée, et une dépendance obligatoire est ajoutée à l'installation dans son mode par défaut (la colonne ci-dessous nomme le service du catalogue ajouté).

Liaison	Fournie par	Type de connexion	Point d'accès	Facultative	Quand rien n'est lié	Description
opensearch	opensearch	-	http	oui	reste non liée (facultative)	OpenSearch qui stocke les intervalles (index jaeger-jaeger-span-* : Jaeger joint le préfixe jaeger à ses noms d'index) ; en mémoire sans lui.
elasticsearch	- (versions >= 8.12, < 9)	elasticsearch	-	oui	reste non liée (facultative)	Elasticsearch que le client exploite déjà, déclaré comme connexion et jamais installé par Navin : il stocke les intervalles (index eai-jaeger-span-* et eai-jaeger-service-*) et passe avant OpenSearch quand les deux sont liés.

Points d'accès

Point d'accès	Schéma	Composant	Port	Chemin	Paramètre TLS	Paramètres de liaison	Secrets de liaison	Commande de provisionnement
otlp_grpc	grpc	jaeger	4417 (otlp_grpc_port)	-	tls_enabled	tls	-	-
query	http	jaeger	16686 (query_port)	-	tls_enabled	-	-	-

Contrôles de santé

Vivacité (par instance)

Composant	Contrôle	Détails
jaeger	HTTP http://127.0.0.1:{{ config.health_port }}/status	Attendu 200 ; 60 tentatives ; intervalle 2 s ; délai 3 s

Disponibilité (contrôle du service)

Contrôle	Détails
HTTP {{ 'https' if config.tls_enabled else 'http' }}://{{ host.fqdn }}:{{ config.query_port }}/api/v3/services	Attendu 200 ; Attendu services

Contrôles préalables

Contrôle	Type	Signification	Sévérité	Composants
query_free	port_free {"param": "query_port"}	port 16686 libre sur l'hôte	bloquant	tous les composants

Désinstallation

Chemins supprimés quand les données sont purgées : {{ paths.log }}.

Liens rapides

• Jaeger : {{ 'https' if config.tls_enabled else 'http' }}://{{ host.fqdn }}:{{ config.query_port }}/

Documentation amont

• Site : https://www.jaegertracing.io
• Sources : https://github.com/jaegertracing/jaeger
• Haute disponibilité : https://www.jaegertracing.io/docs/2.22/storage/