Aller au contenu principal

Loki sur Google Cloud Run

Loki sur Google Cloud Run

Grafana Loki est un système d'agrégation de logs horizontalement scalable et hautement disponible — souvent décrit comme "Prometheus pour les logs". Contrairement aux indexeurs de logs en texte intégral, Loki n'indexe qu'un petit ensemble de labels par flux de logs plutôt que le texte intégral de chaque ligne, ce qui maintient les coûts de stockage et d'exploitation bas. Il est normalement interrogé avec LogQL via Grafana (en tant que source de données) ou l'outil LogCLI, avec un agent tel que Promtail ou Grafana Alloy qui y envoie les logs. Ce module déploie Loki lui-même, pas Grafana, sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud que Loki utilise et comment les explorer et les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toute application Cloud Run — identité de service, ingress et équilibrage de charge, scaling et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.


Ce que Loki coûte sur RAD, et comment cela se compare​

Loki sur le module Cloud Run de RAD coûte environ 16 $ US par mois dans votre propre projet. RAD facture 40 crédits une fois par déploiement dans votre propre projet (36 crédits, 10 % de moins, dans un projet géré par RAD). Les builds sont inclus dans le prix. Loki se déploie également sur GKE Autopilot pour environ 40 $ US par mois — consultez le guide GKE si vous avez besoin qu'il y soit exécuté à la place. Si vous n'en avez besoin qu'occasionnellement, un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ce chiffre mensuel devient quelques dollars à la place — voir Mettez-le en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Dans un projet Google Cloud que vous possédezDans un projet que RAD gère pour vous
Frais de module, une fois par déploiement40 crédits (4,00 $ US au prix de la recharge)36 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés pour le temps de build à la minuteIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 16 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 16 crédits par jour, environ 480 par mois (environ 48 $ US au prix de la recharge)
Qui possède quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est maintenu en réserve

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).

10 crédits coûtent 1 $ US pour une recharge ponctuelle, et moins pour un plan mensuel. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par chaque application du projet, de sorte qu'une deuxième application n'ajoute pas une deuxième base de données.

Coût d'exécution par défaut dans votre propre projet (us-central1, prix catalogue Google) :

Ressource (par défaut du module)Par mois
Cloud Run, 1x vCPU / 0,5 GiB (chaud)10 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Totalenviron 16 $ US

Comment cela se compare​

  • Le plan Pro de Grafana Cloud facture des frais de plateforme de 19 $ US par mois plus l'utilisation — 0,050 $/Go traités, 0,400 $/Go écrits et 0,100 $/Go conservés, avec 30 jours de rétention inclus.
  • Le module Loki de RAD coûte environ 16 $ US par mois dans votre propre projet — plus que les frais de base de Grafana Cloud à très faible volume de logs, mais il n'est pas mesuré par le volume d'ingestion : les logs restent dans votre propre projet et bucket plutôt que sur une plateforme multi-tenant partagée, et il n'y a pas de frais d'écriture/rétention par Go à budgétiser.
  • Comparaison auto-gérée : à 1 vCPU / 0,5 GiB, Loki tient confortablement sur un droplet Hetzner CPX22 ou DigitalOcean 2 vCPU/4 Go (tous deux ~24 $/mois) — mais vous gérez alors le câblage du stockage objet, les sauvegardes et les mises à niveau vous-même.

Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le quand vous en avez besoin​

Si Loki s'exécute dans un projet que RAD gère pour vous, vous avez une deuxième option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à Loki dont vous n'avez besoin qu'occasionnellement — évaluation, environnement de démonstration, charge de travail saisonnière ou intermittente — que de le faire fonctionner en continu.

Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, seront utilisables après sa restauration, de sorte que la restauration ne peut pas être invoquée comme moyen de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.

  • Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. Comme la facturation est déjà déliée, rien n'est facturé pendant qu'il attend. Contrairement à la suppression d'un module, cela ne détruit pas la base de données, une VM ou la ressource de calcul une par une — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Mettre à jour sur chaque déploiement pour confirmer que tout est revenu. Parce que rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 48 $ US par mois pour le maintenir en fonctionnement. Déployez Loki, utilisez-le un certain temps, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Mettre à jour, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez les frais de module qu'une seule fois et le temps qu'il a été réellement actif.
  • Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox que la plupart des utilisations d'évaluation conviennent). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Une lacune réelle : les sauvegardes nocturnes ne survivent pas. Les sauvegardes et autres fichiers générés sont écrits dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé Loki et souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Payez uniquement pendant que vous l'utilisez, l'autre façon : supprimer et redéployer​

L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le déployer à nouveau lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) — 40 crédits (4,00 $ US) au total. La suppression permet d'économiser de l'argent seulement si Loki reste inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — environ 9 jours ou plus, à la fois dans votre propre projet (environ 0,53 $ US par jour) et dans un projet géré par RAD (16 crédits par jour).
  • Rien ici n'est partagé. Loki ne dépend pas d'une base de données, d'une VM ou d'un cluster qui lui est propre, donc sa suppression permet d'économiser immédiatement son coût d'exécution total.
  • Conservez d'abord vos données. Les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, donc copiez la dernière sauvegarde avant de la supprimer si vous voulez la conserver.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation. Un formateur anime une session pour une classe. Chaque participant obtient l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation que le formateur définit. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
  • Environnements gérés, pour les sociétés de conseil. Un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.

Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.

Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; frais RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour les mécanismes de pause/restauration et ce qu'il dit sur les objets Cloud Storage sans suppression logicielle ; Grafana Cloud. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

Loki s'exécute comme un conteneur binaire Go unique sur Cloud Run v2, en mode monolithique (-target=all, le mode par défaut de Loki, qui exécute chaque composant interne — distributeur, ingester, querier, compactor — dans un seul processus). Le déploiement relie un ensemble étroit de services Google Cloud centrés sur GCS :

CapacitéService Google CloudNotes
CalculCloud Run v2Service binaire Go, 1 vCPU / 512 Mio par défaut, facturation basée sur les requêtes
Stockage objetCloud StorageUn seul bucket storage — le véritable backend de stockage objet de Loki pour les chunks et l'index TSDB expédié, pas un stockage de fichiers accessoire
SecretsSecret ManagerAucun généré — Loki_Common déclare secret_ids = {}
IngressURL Cloud RunURL run.app par défaut ; équilibreur de charge HTTPS externe optionnel + domaine personnalisé

Valeurs par défaut judicieuses à connaître d'emblée :

  • Pas de base de données, pas de Redis. L'état durable de Loki (chunks, index TSDB) réside entièrement dans un bucket GCS. database_type = "NONE" et enable_redis n'ont aucun effet sur la propre configuration de Loki.
  • max_instance_count est effectivement épinglé à 1. Loki_Common écrase max_instance_count = 1 dans la configuration qu'il transmet à App_CloudRun, quelle que soit la valeur passée. Le compactor de Loki (rétention/suppression) est un véritable singleton et la configuration intégrée utilise un anneau en mémoire (common.ring.kvstore.store: inmemory) avec replication_factor: 1, qui ne peut pas se coordonner entre plusieurs instances.
  • Mono-tenant, pas d'authentification. La configuration intégrée définit auth_enabled: false. Il n'y a pas d'isolation par tenant et pas d'authentification intégrée — l'API HTTP de Loki est accessible par quiconque peut atteindre l'URL du service, sous réserve de ingress_settings.
  • Facturation basée sur les requêtes par défaut (cpu_always_allocated = false). L'ingestion, la requête et le cycle de compaction interne de Loki s'exécutent tous en réponse directe aux requêtes HTTP, sans travail de fond de longue durée nécessitant du CPU au repos.
  • Piloté par fichier de configuration, pas par variable d'environnement. Les paramètres de stockage/schéma de Loki résident entièrement dans un fichier de configuration intégré à l'image ; seul le nom du bucket GCS est modélisé au démarrage du conteneur via la variable d'environnement LOKI_GCS_BUCKET.
  • Pas de jobs d'initialisation. initialization_jobs est par défaut [] — Loki n'a rien à amorcer.
  • Image personnalisée, basée sur distroless. Voir §4 et §7 pour comprendre pourquoi le Dockerfile de ce module semble inhabituel.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms de services et de ressources sont rapportés dans les Sorties du déploiement.

A. Cloud Run — le service Loki​

Loki s'exécute comme un service Cloud Run v2 unique qui s'adapte automatiquement à la charge des requêtes. Parce que max_instance_count est effectivement épinglé à 1, "autoscaling" signifie ici plutôt mise à l'échelle à zéro et retour plutôt que répartition horizontale.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les logs et les métriques.
  • CLI :
    gcloud run services list --project "$PROJECT" --region "$REGION"
    gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION"
    gcloud run revisions list --service <service-name> --project "$PROJECT" --region "$REGION"

Voir App_CloudRun pour la mise à l'échelle, la concurrence, l'environnement d'exécution et la répartition du trafic.

B. Cloud Storage — le backend de stockage objet de Loki​

Un bucket GCS storage dédié est le véritable backend de stockage de Loki, pas un supplément optionnel. Loki écrit les chunks de logs compressés et les shards d'index TSDB expédiés directement via son client de stockage natif gcs (Application Default Credentials — le compte de service d'exécution Cloud Run se voit accorder roles/storage.objectAdmin sur le bucket).

  • Console : Cloud Storage → Buckets → sélectionnez le bucket storage.
  • CLI :
    gcloud storage buckets list --project "$PROJECT" --filter="name~storage"
    gcloud storage ls gs://<storage-bucket>/ # top-level layout
    gcloud storage ls gs://<storage-bucket>/index_*/ # TSDB index shards (schema prefix "index_")
    gcloud storage du -s gs://<storage-bucket>/ # total bytes stored
    Les objets de chunk et les shards d'index s'accumulent sous la racine du bucket et les préfixes index_* respectivement, selon le schema_config intégré à l'image (schema: v13, index.prefix: index_, index.period: 24h).

Voir App_CloudRun pour les options GCS Fuse et CMEK (non utilisées par le propre chemin de stockage de Loki, qui est un accès natif à l'API GCS, pas un système de fichiers monté).

C. Secret Manager​

Aucun secret n'est généré pour Loki — Loki_Common déclare secret_ids = {} et secret_values = {}. Tous les secrets que vous ajoutez via secret_environment_variables sont vos propres valeurs fournies par l'opérateur (par exemple, si vous placez Loki derrière une couche d'authentification de proxy inverse).

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT"

D. Réseau et ingress​

Le service est accessible par son URL run.app par défaut (ingress_settings = "all"), ce qui permet aux clients d'envoi de logs (Promtail, Alloy) en dehors du VPC du projet de pousser les logs. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés.

  • Console : Cloud Run (URL du service) ; Services réseau → Équilibrage de charge.
  • CLI :
    gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
    gcloud compute addresses list --project "$PROJECT"

Voir App_CloudRun.

E. Cloud Logging et Monitoring​

Les propres logs de processus de Loki (pas les logs qu'il ingère — ce sont des données d'application à l'intérieur du service Loki, pas des entrées Cloud Logging) sont acheminés vers Cloud Logging ; les métriques Cloud Run sont acheminées vers Cloud Monitoring, avec des vérifications de disponibilité et des politiques d'alerte optionnelles.

  • Console : Logging → Explorateur de logs ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50

3. Interroger Loki​

Ce module déploie Loki sans interface web intégrée — Loki est un frontal pour les logs, interrogé via LogQL. Deux façons courantes de l'interroger une fois déployé :

  • logcli (l'outil CLI officiel de Grafana), pointé vers l'URL du service :
    export LOKI_ADDR="$SERVICE_URL"
    logcli labels # discover available labels
    logcli query '{job="myapp"}' --limit=50 # LogQL query
  • HTTP direct contre l'API de requête :
    curl -s "$SERVICE_URL/loki/api/v1/query?query=%7Bjob%3D%22myapp%22%7D" | jq .
  • En tant que source de données Grafana — ajoutez une source de données Loki dans Grafana pointant vers l' URL du service ; c'est le modèle de production normal pour explorer et créer des tableaux de bord à partir des logs ingérés.

4. Comportement de l'application Loki​

  • Modélisation de la configuration au démarrage du conteneur, pas de migrations de base de données. Loki_Common intègre un modèle de configuration dans l'image avec un seul espace réservé, __LOKI_GCS_BUCKET__. Le point d'entrée du conteneur substitue le nom réel du bucket (injecté comme variable d'environnement LOKI_GCS_BUCKET) par sed et écrit le résultat dans /etc/loki/local-config.yaml avant que Loki ne démarre — il n'y a pas d'étape de schéma de premier démarrage à attendre.
  • Pas de jobs d'initialisation nécessaires. Loki n'a pas de base de données à amorcer, donc initialization_jobs est vide par défaut et ce module n'en injecte jamais.
  • Le chemin de santé est /ready. Les sondes de démarrage et de vivacité ciblent le point de terminaison de disponibilité intégré et non authentifié de Loki, qui renvoie HTTP 200 une fois que le serveur écoute — généralement en quelques secondes, car il n'y a pas de migration ou de travail lourd au premier démarrage.
  • Mode monolithique. -target=all exécute chaque composant Loki (distributeur, ingester, querier, query-frontend, compactor) au sein du processus unique — la forme appropriée pour un déploiement mono-tenant de petite/moyenne taille. Loki prend également en charge un mode microservices (conteneurs séparés par composant) pour les déploiements à très grande échelle, que ce module n'implémente pas.
  • Contrainte de mise à l'échelle à instance unique. L'anneau en mémoire (common.ring.kvstore.store: inmemory) et le job de rétention singleton du compactor signifient que Loki n'est pas conçu pour exécuter plus d'une instance simultanément. Loki_Common applique cela en épinglant max_instance_count = 1 dans la configuration qu'il transmet à la Fondation, quelle que soit la valeur d'entrée de la plateforme.
  • Rétention. La configuration intégrée définit limits_config.retention_period: 720h (30 jours) avec le compactor effectuant la suppression (retention_enabled: true, delete_request_store: gcs).
  • Inspecter l'environnement du conteneur en cours d'exécution (par exemple pour confirmer que le bucket a bien été injecté) :
    gcloud run services describe <service-name> --region "$REGION" \
    --format='value(spec.template.spec.containers[0].env)'

5. Variables de configuration​

Les variables sont regroupées exactement comme elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour Loki sont listés ; toute autre entrée est héritée de App_CloudRun avec son comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namelokiNom de base des ressources. Ne pas modifier après le premier déploiement.
application_versionlatest"latest" se résout en l'ARG de build LOKI_VERSION épinglé (3.6.12) — pas le générique APP_VERSION, que la Fondation forcerait autrement à une balise Loki latest inexistante. Définissez une balise explicite (par exemple 3.6.12) pour épingler une version spécifique.

Groupe 4 — Exécution et mise à l'échelle​

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_port3100Port d'écoute HTTP de Loki — fixé par la configuration intégrée (server.http_listen_port). Modifier cela sans modifier également le modèle de configuration rompra le déploiement.
max_instance_count1Surchargé à 1 par Loki_Common quelle que soit cette valeur — voir §1.
cpu_limit / memory_limit1000m / 512MiLimites de ressources par instance. Augmentez la mémoire pour les ensembles de labels à cardinalité élevée ou les charges de requêtes lourdes.
cpu_always_allocatedfalseFacturation basée sur les requêtes — Loki n'a pas de travail de fond inactif.
enable_cloudsql_volumefalseDésactivé — Loki n'a pas de base de données.
execution_environmentgen2Gen2 recommandé.

Groupe 5 — Accès et réseau​

VariableValeur par défautDescription
ingress_settingsallall est requis pour que les clients d'envoi de logs externes (Promtail, Alloy) en dehors du VPC du projet puissent atteindre l'API push.
enable_iapfalseL'activation d'IAP bloque les push/requêtes de logs non authentifiés provenant d'agents externes.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Variables d'environnement en texte brut supplémentaires, fusionnées sur LOKI_GCS_BUCKET (injectées automatiquement). Loki ne lit presque rien de l'environnement — sa configuration est pilotée par fichier.
secret_environment_variables{}Aucun secret n'est nécessaire par défaut.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
storage_buckets[]Buckets supplémentaires au-delà du bucket storage auto-provisionné que Loki utilise réellement pour les chunks/index.
enable_nfsfalseNon nécessaire pour le propre stockage de Loki (basé sur GCS), contrairement aux applications basées sur SQLite dans ce catalogue.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typeNONEFixe — le stockage durable de Loki est le bucket GCS, pas Cloud SQL. Toutes les autres variables du Groupe 12 sont inertes.

Groupe 13 — Jobs et tâches planifiées​

VariableValeur par défautDescription
initialization_jobs[]Loki n'a pas besoin de job d'initialisation. Laissé vide par ce module et Loki_Common.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe / liveness_probeHTTP /ready, délai de 30sPoint de terminaison de disponibilité intégré de Loki — devient sain en quelques secondes car il n'y a pas d'étape de migration.

Groupe 16 — Redis​

VariableValeur par défautDescription
enable_redisfalseLoki n'a pas d'utilisation intégrée pour Redis ; cela n'existe que pour la complétude de la mise en miroir de la Fondation.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.


6. Sorties​

Retourné lors d'un déploiement réussi — le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Cloud Run.
api_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
storage_bucketsBuckets Cloud Storage créés — inclut le bucket storage que Loki utilise pour les chunks et l'index TSDB.
database_instance_name / database_name / database_user / database_password_secretToujours vide — database_type = "NONE".
container_image / container_registryImage déployée et dépôt Artifact Registry.
network_name / network_exists / regionsRéseau VPC, présence, régions.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesStatut de surveillance, canaux, vérifications de disponibilité.
initialization_jobsToujours vide — Loki n'a pas besoin de job d'initialisation.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_url / cicd_configurationStatut et détails CI/CD.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeStatut VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et statut CMEK.

7. Pièges de configuration et valeurs par défaut judicieuses​

Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).

Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur de la fondation App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'à l'application ou à l'exécution.

Note pour les opérateurs/mainteneurs : pourquoi le Dockerfile de ce module semble inhabituel. L'image officielle grafana/loki est véritablement distroless — l'inspection de son système de fichiers ne montre que /usr/bin/loki, sans shell, sans coreutils, et sans aucun lieur dynamique. Un modèle Dockerfile standard (RUN chmod +x /entrypoint.sh) échoue carrément au moment de la construction (exec: /bin/sh: no such file or directory) car RUN a besoin d'un shell. La première tentative de correction — greffer un binaire busybox de la balise busybox:stable par défaut via un COPY multi-étapes — a également échoué, avec l'erreur plus confuse exec /bin/busybox: no such file or directory, car le binaire de busybox:stable est lié dynamiquement et la cible distroless n'a pas de lieur dynamique pour le satisfaire. La solution a été de passer à busybox:musl, vérifié via file comme étant véritablement lié statiquement (aucun interpréteur nécessaire) : FROM busybox:musl AS busybox dans une étape de construction uniquement, COPY --from=busybox /bin/busybox /bin/busybox dans l'image finale basée sur distroless, et ENTRYPOINT ["/bin/busybox", "sh", "/entrypoint.sh"] (busybox invoqué directement par chemin absolu — aucun lien symbolique d'applet n'existe, donc même le script d'entrée lui-même appelle /bin/busybox sed ... plutôt qu'un simple sed). Si jamais vous touchez ce Dockerfile, ou le clonez pour une autre application basée sur distroless, rappelez-vous : vérifiez qu'une balise busybox greffée est véritablement statique (file <binary> ne devrait pas afficher interpreter / lié dynamiquement) avant de supposer qu'elle s'exécutera dans une cible distroless.

ParamètreValeur judicieuseRisqueConséquence si incorrect
max_instance_countLaisser par défaut (effectivement épinglé à 1)CritiqueMême si Loki_Common remplace cela par 1 dans la configuration qu'il transmet à la Fondation, ne comptez pas sur la mise à l'échelle horizontale de Loki dans cette forme de déploiement — l'anneau en mémoire et le compactor singleton ne sont pas conçus pour des instances concurrentes.
container_port3100 (ne pas modifier sans également éditer le modèle de configuration)CritiqueLe server.http_listen_port de Loki est intégré au fichier de configuration, non lu depuis container_port à l'exécution — les faire correspondre rompt le routage entre Cloud Run et le conteneur.
ingress_settingsall pour l'envoi de logs externesÉlevéLa définition de internal bloque les agents Promtail/Alloy s'exécutant en dehors du VPC du projet pour pousser les logs.
enable_iapfalse à moins que tous les clients d'envoi de logs ne puissent s'authentifier via IAPÉlevéIAP bloque toutes les requêtes non authentifiées, y compris l'API push utilisée par les agents d'envoi de logs.
Contrôle d'accèsAucun par défaut (auth_enabled: false)ÉlevéL'API HTTP de Loki (push et query) n'a pas d'authentification intégrée. Quiconque peut atteindre l'URL du service peut pousser ou interroger des logs. Protégez-le avec IAP, une politique Cloud Armor ou une couche d'authentification de proxy inverse si cela est important pour votre déploiement.
application_versionÉpinglez une balise explicite (par exemple 3.6.12) pour la productionMoyen"latest" se résout silencieusement à la balise que le Dockerfile de Loki_Common épingle actuellement, ce qui ne change que lorsque la source du module change — pas un latest en amont en direct, mais pas non plus quelque chose que vous contrôlez par déploiement sans définir une balise explicite.
memory_limitAugmenter au-dessus de 512Mi pour les labels à cardinalité élevée ou les charges de requêtes lourdesMoyenLe moteur de requêtes de Loki et le cache d'index en mémoire peuvent manquer de mémoire sous charge avec la valeur par défaut conservative.
database_typeLaisser à NONEFaibleDéfinir autre chose n'a aucun effet — Loki_Common ne connecte jamais une connexion de base de données à la configuration de Loki, quoi qu'il arrive.

Pour le comportement de la fondation référencé tout au long — identité de service, mise à l'échelle et concurrence, ingress et équilibrage de charge, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_CloudRun. La configuration d'application spécifique à Loki partagée avec la variante GKE est décrite dans Loki_Common.

Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.