Monitoring de l'agent

L'agent peut être supervisé en utilisant deux approches : avec les logs techniques (pour obtenir des informations sur le comportement interne de l'agent), et en utilisant des métriques Prometheus, pour collecter des informations sur la performance et le trafic de l'agent.

Logs techniques

L'agent peut être configuré pour enregistrer des informations techniques sur son comportement interne, ce qui peut être utile à des fins de débogage ou pour surveiller la santé de l'agent. Les logs techniques sont différents des logs d'accès, car ils ne sont pas focalisés sur les requêtes HTTP entrantes, mais plutôt sur les opérations internes de l'agent telles que la gestion des règles, la communication avec les serveurs backend, la gestion des certificats SSL, la collecte de logs, etc.

La clé de configuration log permet de spécifier le type de sortie (sous forme de fichier, sur la sortie standard ou vers un serveur syslog), le format des logs (json, text, rfc3164 ou rfc5424) et le chemin vers le fichier de log.

Par exemple :

instance:
    name: 'My Instance'
reverse_proxy:
    listen:
        - 'tcp://0.0.0.0:80'
    forward:
        address: 'backend:8080'
    agent:
        project_key: my-project-key
log:
    -
        output: file
        format: json
        path: /var/log/redirection.log.json
    -
        output: stdout
        format: text
    -
        output: stderr
        format: json
    -
        output: syslog
        format: rfc5424
        address: 'syslog-server:514'

Métriques Prometheus

L'agent redirection.io peut exposer un ensemble de métriques Prometheus qui peuvent être utilisées pour superviser la performance et le trafic de l'agent.

Par défaut, l'endpoint de métriques est désactivé, mais vous pouvez l'activer en configurant la clé de configuration metrics.listen dans le fichier de configuration de l'agent.

Par exemple :

instance:
    name: 'My Instance'
reverse_proxy:
    listen:
        - 'tcp://0.0.0.0:80'
    forward:
        address: 'backend:8080'
    agent:
        project_key: my-project-key
metrics:
    listen: '127.0.0.1:9000'

Les métriques Prometheus incluent :

• métriques globales de l'agent :
  • process_cpu_seconds_total: Total user and system CPU time spent, in seconds.
  • process_cpu_seconds_total : Temps CPU total utilisateur et système passé, en secondes.
  • process_max_fds : Nombre maximum de descripteurs de fichiers ouverts autorisés pour le processus de l'agent.
  • process_open_fds : Nombre de descripteurs de fichiers ouverts.
  • process_resident_memory_bytes : Taille de la mémoire résidente, en octets.
  • process_start_time_seconds : Heure de démarrage du processus depuis l'unix epoch en secondes.
  • process_threads : Nombre de threads OS dans le processus.
  • process_virtual_memory_bytes : Taille de la mémoire virtuelle en octets.
• métriques par projet :
  • redirectionio_matching_requests : Nombre de fois qu'une requête correspondante a été exécutée par le router
  • redirectionio_rules_count : Nombre de règles à l'intérieur du router
  • redirectionio_rules_count_live : Nombre de règles à l'intérieur du router (en mode live)
  • redirectionio_rules_update_histogram : Histogramme de la durée du processus de mise à jour des règles, en millisecondes
  • redirectionio_logs_buffer_size : Taille mémoire du buffer de logs, en octets
• métriques par hostname :
  • redirectionio_request_bytes : Nombre d'octets reçus dans les requêtes
  • redirectionio_response_bytes : Nombre d'octets envoyés dans les réponses
  • redirectionio_request_count : Nombre de requêtes reçues par l'agent