Options de démarrage de Looker

Il existe un certain nombre de paramètres de démarrage Looker qui peuvent être configurés en option sur les instances hébergées par le client. Si vous n'avez pas besoin de modifier ces options, vous pouvez démarrer Looker sans elles.

Liste des options de démarrage

Le tableau suivant présente la liste des options de démarrage actuelles par ordre alphabétique. Vous pouvez également afficher la liste des options de démarrage en exécutant le script de démarrage Looker avec l'option --help.

Option Description
--alerts-scheduler-threads=<i> Nombre d'alertes programmées simultanées (par défaut : 3).
--ami Obsolète. Utilisez plutôt --marketplace=aws.
--api-server-max-threads=<i> Nombre maximal de threads pour le serveur d'API Puma.
--api-server-min-threads=<i> Nombre minimal de threads pour le serveur d'API Puma.
--application-server-max-threads=<i> Nombre maximal de threads pour le serveur d'application Puma.
--application-server-min-threads=<i> Nombre minimal de threads pour le serveur d'applications Puma.
--apply-db-migrations Appliquez les migrations de bases de données au démarrage. Ne désactivez cette option que si vous appliquez les migrations séparément (par défaut : true).
--async-results-cache-time=<i> Durée pendant laquelle les résultats asynchrones doivent être conservés en cache (par défaut : 300).
--byoid-studio-load-url=<s> URL permettant de charger BYOID Studio dans un iFrame.
--cdn-hosts=<s> Noms d'hôte séparés par une virgule pour le pool de CDN (par défaut : static-a.lookercdn.com,static-b.lookercdn.com).
--cipher-key-file=<s> Chemin d'accès au fichier contenant la clé de chiffrement (chiffrement ancien uniquement).
--cloud-trace-enabled Activez le traçage à l'aide des identifiants par défaut ou des identifiants JSON s'ils sont fournis via cloud_trace_json_file (par défaut : false).
--cloud-trace-json-file=<s> Fichier JSON contenant les identifiants du compte de service permettant d'importer des données de trace dans Google Cloud Trace.
--cloud-trace-project-id=<s> ID du projet Google dans lequel importer les données de trace.
--cloud-trace-sample-rate=<f> Taux (0 à 1) d'échantillonnage des traces (par défaut : 0,0).
--clustered Indique si ce serveur fait partie d'un cluster (par défaut : false).
--concurrent-render-caching-jobs=<i> Nombre de processus de mise en cache du rendu simultanés (par défaut : 3).
--concurrent-render-jobs=<i> Nombre de processus de rendu PhantomJS ou Chromium simultanés (par défaut : 2).
--core-on-loopback Expose l'API Core sur l'interface de bouclage (par défaut : false).
--core-port=<i> Port sur lequel exécuter le cœur (par défaut : 19999).
--customer-artifact-maxsize=<i> Taille maximale (en Mo) du dépôt d'artefacts client.
-d, --internal-db-creds=<s> Chemin d'accès au fichier YAML contenant les identifiants de la base de données.
--daemonize S'exécute en tant que daemon (valeur par défaut : true).
--default-mailer-domain=<s> Domaine de l'expéditeur par défaut.
--default-mailer-fromemail=<s> Adresse e-mail à partir de laquelle les e-mails de l'outil de messagerie par défaut sont envoyés (par défaut : Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Nom d'hôte de l'outil d'envoi de courrier par défaut (smtp.sendgrid.net par défaut).
--default-mailer-password=<s> Mot de passe de l'outil d'envoi d'e-mails par défaut (il est déconseillé de spécifier un mot de passe sur la ligne de commande).
--default-mailer-port=<i> Port du programme d'envoi de courrier par défaut (par défaut : 587).
--default-mailer-username=<s> Nom d'utilisateur de l'outil d'envoi de courrier par défaut.
--disable-db-log Désactive la journalisation des requêtes de base de données internes (par défaut : false).
--dogstatsd-host-ip=<s> Adresse IP de l'hôte du serveur statsd Datadog.
--dogstatsd-host-port=<i> Port hôte du serveur Datadog.
-e, --help Affiche cette liste d'options de démarrage.
--enable-blobstore-recryption Activez le rechiffrement persistant de Blobstore lors des opérations de clé (par défaut : false).
--error-emails-to=<s> E-mails d'erreur envoyés à <email address>.
--experimental-features=<s> Liste des fonctionnalités expérimentales autorisées, séparées par une virgule.
--experimental-routes=<s> Liste de routes expérimentales autorisées, séparées par une virgule, qui génèrent des routes avec le suffixe -next.
--extension-load-url=<s> URL permettant de charger les extensions dans un iFrame sécurisé.
--external-solr-enabled Activez Solr externe (par opposition à Solr intégré, qui est la valeur par défaut) (par défaut : false).
--fips Activer le chiffrement FIPS-140 (par défaut : false).
--force-cdn Force l'activation du CDN (par défaut : false).
--force-cipher-key Ignore les mesures de protection pour les paramètres de clé de chiffrement (chiffrement hérité uniquement, valeur par défaut : false).
--force-enable-pendo Active les guides Pendo sur les instances en marque blanche ou dans les contextes d'intégration (par défaut : false).
--force-error-emails Force Looker à signaler les erreurs par e-mail (par défaut : false).
--force-gcm-encryption OBSOLÈTE (cette option n'est plus nécessaire).
--force-mismatched-internal-db Permet d'utiliser une base de données interne Looker non synchronisée (par défaut : false).
--force-no-cdn Désactive de force le CDN (par défaut : false).
--git-hooks-use-local-path Utilisez un chemin d'accès local pour le répertoire git_hooks au lieu du stockage partagé.
--git-performance-logging Active la journalisation des performances JGit (par défaut : false).
--google-analytics-tracker-id=<s> ID de suivi à utiliser pour envoyer des pages vues à des trackers Google Analytics supplémentaires.
-h, --hosted Hébergé par Looker.
-H, --hostname=<s> Nom d'hôte pour la communication de nœud à nœud.
--hosted-action-hub-disabled Désactivez le hub d'actions hébergé.
--in-memory-cache-size=<i> Taille (en Mo) du cache en mémoire (par défaut : 200).
--integration-proxy-cert=<s> Chemin d'accès au fichier de certificat PKI du proxy d'intégration.
--integration-proxy-key=<s> Chemin d'accès au fichier de clé PKI du proxy d'intégration.
--internal-analytics-connection-file=<s> Fichier YAML décrivant la connexion d'analyse interne qui héberge les données du modèle system__activity. Cette option ne doit être utilisée qu'avec une base de données backend d'instance dupliquée avec accès en lecture.
--internal-analytics-connection-pool-size=<i> Nombre de connexions simultanées à la base de données pouvant exécuter des requêtes de modèle d'activité système. Cette option ne doit être utilisée qu'avec une base de données backend d'instance dupliquée avec accès en lecture.
--internal-analytics-retention-days=<i> Nombre de jours pendant lesquels les données d'historique doivent être conservées dans la base de données interne. Cela n'affecte aucun processus ETL. La valeur par défaut est 90. Cette option ne doit être utilisée qu'avec une base de données backend d'instance dupliquée avec accès en lecture.
--k8s-deployment-api-s3bucket-url=<s> URL où ce processus Looker peut écrire les identifiants du bucket S3 à conserver en tant que secrets Kubernetes.
--log-format=<s> Format du journal : text ou json (par défaut : text).
--log-level=<s> Niveau de journalisation (par défaut : info).
--log-to-file Envoie la sortie du journal au fichier journal Looker (par défaut : true).
--lookml-runtime-cache-size=<i> Taille (en Mo) du cache du moteur d'exécution LookML (par défaut : 200).
--loose-cipher-key-file Ne pas exiger les autorisations 0600 pour le fichier de clé de chiffrement (chiffrement hérité uniquement, valeur par défaut : false).
--marketplace=<s> Exécution dans une instance Marketplace Looker.
--max-async-threads=<i> Nombre maximal de threads de requêtes asynchrones (par défaut : 200).
--max-configurable-db-connections=<i> Nombre maximal de connexions autorisées pour une connexion à une base de données client dans l'UI.
--max-db-connections-records=<i> Nombre maximal d'enregistrements de connexion autorisés dans la table db_connection (par défaut : 10 000).
--max-pdt-regen-threads=<i> Nombre maximal de threads du générateur de tables PDT.
--max-scheduled-plans=<i> Nombre maximal de plans programmés récurrents actifs (par défaut : unlimited).
--max-scheduler-jitter-in-seconds=<i> Indicateur permettant de répartir aléatoirement les exécutions de planification sur le nombre de secondes indiqué.
--max-unstreamed-limit=<i> Définit le nombre maximal de lignes pouvant être renvoyées pour toutes les requêtes qui ne sont pas diffusées en flux continu (par défaut : 100 000).
--min-pdt-regen-threads=<i> Nombre minimal de threads pour le générateur de PDT.
--monitoring-port=<i> Port pour l'hébergement de la surveillance (Prometheus, etc.). La valeur par défaut est 1552.
-n, --node-to-node-port=<i> Port pour la communication de nœud à nœud (par défaut : 1551).
--new-cipher-key-file=<s> Chemin d'accès au fichier contenant la nouvelle clé de chiffrement (chiffrement hérité uniquement).
--on-disk-cache-size=<i> Taille (en Mo) du cache disque (par défaut : 2000).
-p, --port=<i> Port sur lequel exécuter le serveur (par défaut : 9999).
--per-user-query-limit=<i> Limite le nombre de requêtes simultanées par utilisateur (par défaut : 15).
--per-user-query-timeout=<i> Durée du délai avant expiration par utilisateur pour l'attente de la connexion (par défaut : 600).
--prefer-ipv4 Préférer IPv4.
--public-embed-auth-param-file=<s> Fichier de paramètres d'authentification pour l'authentification publique.
--public-host-url=<s> Si la fonctionnalité de licence public_host_url est activée, cette option permet aux administrateurs de spécifier un nom d'hôte public_host_url afin que les URI de rappel de l'API Looker Action soient construits avec le public_host_url plutôt qu'avec l'URL d'hôte par défaut dans Looker. L'entrée de l'option de démarrage doit être https://<my.host.name> sans barre oblique à la fin de l'URL. Si vous utilisez cette méthode, les administrateurs Looker doivent également ajouter à la liste d'autorisation les adresses IP de sortie statiques listées sur la page de documentation Partager des données via un hub d'actions.
-q, --queue-broker-port=<i> Port du broker de file d'attente (par défaut : 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> Intervalle de veille maximal avant que l'API de longue interrogation ne vérifie si des résultats sont disponibles (par défaut : 1).
--qm-long-poll-sleep-interval-in-seconds=<i> Intervalle de veille initial avant que l'API de longue interrogation ne vérifie si des résultats sont disponibles (par défaut : 0,1).
--qm-long-poll-timeout-in-seconds=<i> Délai avant expiration maximal côté serveur pour l'API Long Poll avant son retour au client (par défaut : 30).
--query-manager-max-threads=<i> Nombre maximal de threads pour le gestionnaire de requêtes.
--query-manager-min-threads=<i> Nombre minimal de threads pour le gestionnaire de requêtes.
--query-metrics-retention-hours=<i> Nombre d'heures pendant lesquelles conserver les données query_metrics dans la base de données interne (par défaut : 336).
--queue-startup-timeout-in-seconds=<i> Durée en secondes pendant laquelle la connexion à la file d'attente est autorisée au démarrage (par défaut : 180).
--query-task-cleanup-interval-seconds=<i> Intervalle entre les tâches de nettoyage du tableau des tâches de requête (par défaut : 600).
--query-task-persistence-duration-minutes=<i> Durée pendant laquelle les lignes doivent être conservées dans la table des tâches de requête une fois la requête terminée (par défaut : 360).
-r, --root Permet l'exécution en tant que root.

Looker ne nécessite pas de droits racine pour fonctionner normalement. Pour des raisons de sécurité, nous vous recommandons d'exécuter Looker dans un compte non racine. N'utilisez l'option d'exécution en tant que root que lorsque cela est nécessaire, par exemple si un analyste Looker vous le demande à des fins de dépannage.
--redis-cache-config-file=<s> Fichier contenant la configuration Redis.
--report-backend-errors, --no-report-backend-errors Signale les erreurs du backend (par défaut : false).
--report-frontend-errors, --no-report-frontend-errors Signale les erreurs du frontend (par défaut : false). REMARQUE : Cette option de démarrage est obsolète. Utilisez plutôt l'option client_monitor.
-S, --ssh-tunnel-sidecar-url=<s> URL de base utilisée pour se connecter au side-car du serveur de tunnel SSH.
--scheduled-job-attempt-limit=<i> Nombre maximal de tentatives de job planifié (par défaut : 10).
--scheduled-job-max-age-days=<i> Âge maximal d'un job planifié avant sa suppression (par défaut : 60).
--scheduler-query-limit=<i> Limite le nombre de requêtes planifiées simultanées (par défaut : 10).
--scheduler-query-timeout=<i> Durée du délai avant expiration du planificateur pour l'attente de la connexion (par défaut : 1 200).
--scheduler-start-delay=<i> Nombre de secondes de retardement du démarrage du gestionnaire de tâches (par défaut : 60).
--scheduler-threads=<i> Nombre de tâches planifiées simultanées (par défaut : 10).
--search-result-comparison Comparez les résultats du service de recherche aux anciens résultats (par défaut : false).
--search-service Active le service de recherche (valeur par défaut : false).
--search-service-ab-test Activez le test A/B pour le service de recherche (par défaut : false).
--self-signup Permet à n'importe qui de créer un compte pour lui-même.
--shared-storage-dir=<s> Chemin d'accès au stockage partagé du système de fichiers réseau.
--snowplow-host=<s> Collecteur Snowplow supplémentaire.
--solr-basic-auth=<s> Identifiants d'authentification de base pour les appels à Solr (valeur par défaut : solr:SolrRocks).
--ssl Utilise SSL (valeur par défaut : true).
--ssl-ca-cert=<s> Obsolète. Utilisez plutôt --ssl-keystore.
--ssl-cert=<s> Obsolète. Utilisez plutôt --ssl-keystore.
--ssl-key=<s> Obsolète. Utilisez plutôt --ssl-keystore.
--ssl-keystore-pass-file=<s> Chemin d'accès au fichier contenant le mot de passe ssl-keystore.
--ssl-keystore-pass=<s> Mot de passe du fichier ssl-keystore.
--ssl-keystore=<s> Chemin d'accès au fichier keystore pour SSL.
--ssl-provided-externally-by=<s> Fournit l'hôte et le port d'un fournisseur SSL externe, tels qu'ils sont accessibles depuis le serveur sur lequel Looker est exécuté. Si aucune valeur n'est spécifiée, le serveur d'application Looker fournit le protocole SSL.

Voici un exemple de proxy SSL devant un cluster Looker :

--ssl-provided-externally-by=192.168.123.13:443

Voici un exemple de fournisseur SSL sur le même hôte que votre instance Looker :

--ssl-provided-externally-by=localhost:443

Une valeur nulle indique que le serveur d'application Looker fournit SSL. Si votre instance Looker s'exécute sur un serveur dont l'accès à l'Internet public est limité, vous devrez spécifier une adresse IP sur votre réseau interne qui est accessible par le serveur de votre instance Looker.
--ssl-provided-externally Obsolète. Utilisez plutôt --ssl-provided-externally-by.
--staging Exécute le serveur en tant que serveur intermédiaire. Cette option empêchera votre instance intermédiaire d'envoyer des rapports planifiés. Toutefois, l'instance intermédiaire continuera d'exécuter les tâches planifiées et d'envoyer des e-mails d'erreur aux propriétaires des plans planifiés en cas de problème avec la tâche planifiée.
--staging-override-email=<s> Envoie les e-mails sur une instance intermédiaire à cette adresse au lieu de leur destination habituelle.
--stereo-data-search-enabled Activez la fonctionnalité de recherche de données stéréo (par défaut : false).
--studio-load-url=<s> URL permettant de charger Studio dans un iFrame.
--studio-one-platform-endpoint=<s> Point de terminaison pour l'API Studio One Platform.
--task-monitor-abandoned-query-in-seconds=<i> Durée écoulée depuis le dernier accès à une tâche pour considérer la tâche de requête comme abandonnée.
--task-monitor-query-startup-interval-in-seconds=<i> Durée utilisée comme période de grâce entre le début de l'exécution des requêtes et la première interrogation longue. Cela permet de laisser plus de temps aux appelants avant de commencer le sondage.
--task-monitor-sleep-interval-in-seconds=<i> Intervalle de veille avant que le thread de suivi des tâches puisse vérifier si des tâches ont été abandonnées.
--unification-jwt-service-account=<s> Compte de service JWT d'unification.
--unlimited-scheduler-threads=<i> Nombre de tâches planifiées simultanées illimitées (par défaut : 3).
--use-custom-jdbc-config Indique s'il faut utiliser une configuration de pilote JDBC personnalisée (par défaut : false).
--user-db-credentials Utilisation limitée. Les connexions peuvent utiliser des identifiants par utilisateur (par défaut : false).
-v, --version Affiche la version et quitte.

Format du fichier d'identifiants

Si vous avez remplacé la base de données de l'application par MySQL, vous aurez besoin d'un fichier d'identifiants nommé looker-db.yml qui inclut les paramètres suivants :

dialect: mysql
host: YOUR_HOSTNAME
username: YOUR_USERNAME
password: YOUR_PASSWORD
database: YOUR_DBNAME
port: YOUR_PORT

Si votre base de données MySQL nécessite une connexion SSL, le fichier looker-db.yml doit également contenir les éléments suivants :

ssl: true

Rendre les options de démarrage permanentes

La méthode recommandée pour rendre les paramètres de configuration de démarrage permanents consiste à créer un fichier nommé lookerstart.cfg dans le répertoire de l'application Looker. Ce fichier sera exécuté par le script de démarrage Looker fourni avec votre fichier looker.jar. Le fichier lookerstart.cfg est l'emplacement recommandé pour définir les variables d'environnement pour JAVAARGS et LOOKERARGS, car elles ne seront pas écrasées lorsque de nouvelles versions du script de démarrage Looker seront installées.

Voici un exemple de fichier lookerstart.cfg qui désactive le protocole SSL de Looker et le configure pour qu'il s'exécute sur le port 8080 :

LOOKERARGS="--no-ssl --port 8080"

Vous devrez redémarrer Looker après avoir modifié lookerstart.cfg.

Étapes suivantes

Une fois que vous avez configuré les options de démarrage de Looker, vous pouvez configurer votre certificat SSL pour un protocole HTTPS approprié.