Grafana Alloy (alloy)

Collecte le journal des unités navin-* et les fichiers sous /var/log/navin et les envoie en journaux OTLP au collecteur OpenTelemetry (puis OpenSearch) ; écriture distante des métriques en option.

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

Résumé

Version	1.10.0
Usage	installer et configurer
Couche	infrastructure (présentée à part)
Catégorie	Observabilité
Méthodes d'installation	binary
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	alloy

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
archive binaire	alloy-linux-amd64.zip	1.10.0	Apache-2.0	https://github.com/grafana/alloy/releases/download/v1.10.0/alloy-linux-amd64.zip, x86_64, somme de contrôle sha256

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)

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
alloy	http	12345/tcp	non

Services et connexions nécessaires

• otel : otel-collector.
• prometheus : prometheus (facultative).
• tetragon : tetragon (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

Composants

Composant	Type	Méthodes d'installation	Ports
Agent Alloy (alloy)	travailleur	binary	12345/tcp

Chaque hôte (every-host) (par défaut)

Un agent par hôte géré.

Ce que le mode déploie :

Composant	Placement
alloy	min 0, recommandé 3

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 Grafana Alloy. La carte affiche la licence Apache-2.0 et les dépendances dont l'installation a besoin.

3. Choisissez les hôtes et le mode. À l'étape Hôtes, cochez les hôtes, puis choisissez le Mode : every-host (par défaut). 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 (otel, prometheus, tetragon) 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	par hôte (per-host)
Haute disponibilité	par hôte (per-host)
Bascule	aucun (none)
Réplication	aucun (none)
Quorum	aucun (none)
Découverte	statique (static)
Point d'entrée	par hôte (per-host)
Documentation officielle	https://github.com/grafana/alloy/blob/main/docs/sources/configure/clustering/configure-alloy.md

Prérequis

Prérequis	Doit être hautement disponible	Modes	Description
otel	non	modes de niveau ha ou cluster	OpenTelemetry Collector recevant les données des agents ; le répliquer (mode gateway) pour qu'un agent ait toujours une destination.

Topologie par mode

Modes	Niveau le plus haut du catalogue	Répartition	Composant du quorum	Domaines de panne	Description
every-host	ha (ha)	par hôte (per-host)	-	-	Un agent sur chaque hôte : chaque hôte se couvre lui-même, la perte d'un hôte ne perd que sa propre couverture.

Remarques

• Le mode cluster d'Alloy s'active composant par composant (seuls les composants compatibles se répartissent le travail) ; le mode du catalogue lance un agent indépendant par hôte et ne l'active pas.

Paramètres de configuration

Général

Paramètre	Type	Défaut	Valeurs permises	Obligatoire	Secret	Redémarrage	Description
Port HTTP (port)	port	12345	-	non	non	non	Port de l'interface et des métriques d'Alloy, lié à l'adresse de l'hôte.
TLS (tls_enabled)	bool	false	-	non	non	non	Servir l'interface et les métriques en HTTPS (bloc http, tls) avec un certificat émis par l'autorité de la console ; Prometheus les collecte alors en https et les vérifie avec cette autorité.
Répertoire des journaux (log_root)	path	/var/log/navin	-	non	non	non	Répertoire dont les fichiers *.log sont envoyés.
Envoyer les métriques de l'hôte (remote_write_metrics)	bool	false	-	non	non	non	Écrire à distance les métriques de l'exportateur Unix vers Prometheus.

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
otel	otel-collector	-	otlp_http	non	otel-collector est ajouté à l'installation	Collecteur OpenTelemetry qui reçoit les journaux (OTLP sur HTTP).
prometheus	prometheus	-	http	oui	reste non liée (facultative)	Prometheus qui reçoit les métriques de l'hôte par écriture distante.
tetragon	tetragon	-	metrics	oui	reste non liée (facultative)	Tetragon dont les métriques restent en boucle locale sur ses hôtes (metrics_local) : Alloy les collecte sur son propre hôte et les envoie à Prometheus par écriture distante.

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
http	http	alloy	12345 (port)	-	tls_enabled	-	-	-

Contrôles de santé

Vivacité (par instance)

Composant	Contrôle	Détails
alloy	HTTP {{ 'https' if config.tls_enabled else 'http' }}://{{ host.fqdn if config.tls_enabled else (host.ip or '127.0.0.1') }}:{{ config.port }}/-/ready	Attendu 200 ; 30 tentatives ; intervalle 1 s ; délai 3 s

Désinstallation

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

Liens rapides

• Interface Alloy : {{ 'https' if config.tls_enabled else 'http' }}://{{ host.fqdn }}:{{ config.port }}/

Documentation amont

• Site : https://grafana.com/oss/alloy/
• Sources : https://github.com/grafana/alloy
• Haute disponibilité : https://github.com/grafana/alloy/blob/main/docs/sources/configure/clustering/configure-alloy.md