Options de démarrage de Looker

Vous pouvez configurer un certain nombre de paramètres de démarrage de Looker 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 les 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 planifié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'applications 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 (valeur par défaut : true).
--async-results-cache-time=<i>	Durée pendant laquelle les résultats asynchrones sont mis en cache (par défaut : 300).
--cdn-hosts=<s>	Noms d'hôte séparés par des virgules pour le pool 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 (ancien chiffrement uniquement).
--cloud-trace-enabled	Activez le traçage à l'aide des identifiants par défaut ou des identifiants JSON, le cas échéant, via cloud_trace_json_file (valeur par défaut : false).
--cloud-trace-json-file=<s>	Fichier JSON contenant les identifiants du compte de service pour importer les données de trace dans Google Cloud Trace.
--cloud-trace-project-id=<s>	ID de projet Google vers 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 de rendu simultanés (valeur 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 du client.
-d, --internal-db-creds=<s>	Chemin d'accès au fichier YAML avec 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 messagerie par défaut.
--default-mailer-fromemail=<s>	Adresse e-mail à partir de laquelle les e-mails du service de messagerie par défaut sont envoyés (par défaut : Looker <[e-mail]>).
--default-mailer-host=<s>	Nom d'hôte du mailer par défaut (par défaut : smtp.sendgrid.net).
--default-mailer-password=<s>	Mot de passe du service de messagerie par défaut (mot de passe sur la ligne de commande non recommandé).
--default-mailer-port=<i>	Port du service de messagerie par défaut (par défaut : 587).
--default-mailer-username=<s>	Nom d'utilisateur de messagerie 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 la liste des options de démarrage.
--enable-blobstore-recryption	Activer le rechiffrement PersistentVolume PersistentVolume lors des opérations de recréation de clé (valeur 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 qui génèrent des routes avec le suffixe -next, séparées par une virgule.
--extension-load-url=<s>	URL permettant de charger des extensions dans un iFrame sécurisé.
--external-solr-enabled	Active Solr externe (par opposition à l'option par défaut : Solr intégré) (par défaut : false).
--fips	Activer le chiffrement FIPS-140 (par défaut : false).
--force-cdn	Activer de force le CDN (par défaut : false).
--force-cipher-key	Ne tient pas compte des mesures de protection appliquées aux paramètres de clé de chiffrement (ancien chiffrement uniquement, valeur par défaut: false).
--force-enable-pendo	Active les guides Pendo sur les instances de libellés privés 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	Autorise l'utilisation de la base de données interne Looker non synchronisée (par défaut: false).
--force-no-cdn	Désactivez de force le CDN (valeur par défaut: false).
--git-hooks-use-local-path	Utilisez un chemin d'accès local pour le répertoire git_hooks plutôt que le stockage partagé.
--git-performance-logging	Active la journalisation des performances de JGit (valeur par défaut : false).
--google-analytics-tracker-id=<s>	ID de suivi à utiliser pour envoyer des pages vues vers d'autres outils de suivi Google Analytics.
-h, --hosted	Organisé par Looker.
-H, --hostname=<s>	Nom d'hôte pour la communication nœud à nœud.
--hosted-action-hub-disabled	Désactivez le Centre d'action 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 sont conservées dans la base de données interne. Cela n'a aucune incidence sur les 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 à laquelle ce processus Looker peut écrire les identifiants du bucket S3 à conserver en tant que secrets Kubernetes.
--log-format=<s>	Format de journal au format 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 d'exécution LookML (par défaut : 200).
--loose-cipher-key-file	Ne nécessite pas l'autorisation 0600 pour le fichier de clé de chiffrement (ancien chiffrement 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ête asynchrones (par défaut: 200).
--max-configurable-db-connections=<i>	Nombre maximal de connexions autorisé pour une connexion à la base de données client dans l'interface utilisateur.
--max-db-connections-records=<i>	Nombre maximal d'enregistrements de connexion autorisés dans la table db_connection (valeur par défaut : 10 000).
--max-pdt-regen-threads=<i>	Nombre maximal de threads de régénérateur de PDT.
--max-scheduled-plans=<i>	Nombre maximal de plans récurrents planifiés actifs (par défaut : unlimited).
--max-scheduler-jitter-in-seconds=<i>	L'indicateur pour lisser la programmation s'exécute de manière aléatoire sur le nombre de secondes donné.
--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 (valeur 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 d'hébergement de la surveillance (Prometheus, etc.) (par défaut : 1552).
-n, --node-to-node-port=<i>	Port de communication 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 (ancien chiffrement uniquement).
--on-disk-cache-size=<i>	Taille (en Mo) du cache disque (par défaut : 2 000).
-p, --port=<i>	Port sur lequel exécuter l'exécution (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 attendre la connexion (par défaut : 600).
--prefer-ipv4	Privilégiez 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 public_host_url plutôt qu'avec l'URL d'hôte par défaut dans Looker. La valeur 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 répertoriées sur la page de documentation Partager des données via un Action Hub.
-q, --queue-broker-port=<i>	Port de l'agent de file d'attente (par défaut: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f>	Intervalle de mise en veille maximal avant que l'API de requête longue vérifie si des résultats sont disponibles (valeur par défaut : 1).
--qm-long-poll-sleep-interval-in-seconds=<i>	Intervalle de mise en veille initial avant que l'API de requête longue vérifie si des résultats sont disponibles (valeur par défaut : 0,1).
--qm-long-poll-timeout-in-seconds=<i>	Délai maximal côté serveur pour l'API Long Poll avant qu'elle ne soit renvoyée 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 les données query_metrics sont conservées 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 (valeur par défaut : 180).
--query-task-cleanup-interval-seconds=<i>	Intervalle entre les tâches de nettoyage de la table des tâches de requête (par défaut: 600).
--query-task-persistence-duration-minutes=<i>	Délai de conservation des lignes après la fin de la requête dans la table des tâches de requête (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 autre que celui racine. Utilisez l'option permettant de n'exécuter en mode root que si 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 (valeur par défaut : false).
--report-frontend-errors, --no-report-frontend-errors	Signale les erreurs du frontend (valeur par défaut : false). REMARQUE : Cette option de démarrage est obsolète. Utilisez plutôt le flag de fonctionnalité client_monitor.
-S, --ssh-tunnel-sidecar-url=<s>	URL de base utilisée pour se connecter au Sidecar du serveur de tunnel SSH.
--scheduled-job-attempt-limit=<i>	Nombre maximal de tentatives de tâches planifiées (par défaut: 10).
--scheduled-job-max-age-days=<i>	Ancienneté maximale d'une tâche planifiée avant sa suppression (par défaut: 60).
--scheduler-query-limit=<i>	Limite le nombre de requêtes programmées simultanées (par défaut: 10).
--scheduler-query-timeout=<i>	Délai d'attente du planificateur pour la connexion (par défaut: 1 200).
--scheduler-start-delay=<i>	Nombre de secondes de retard du démarrage de l'exécuteur 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 résultats précédents (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 (valeur par défaut : false).
--self-signup	Permet à quiconque de créer son propre compte.
--shared-storage-dir=<s>	Chemin d'accès à l'espace de stockage partagé du système de fichiers réseau.
--snowplow-host=<s>	Collecteur de chasse-neige supplémentaire.
--solr-basic-auth=<s>	Identifiants d'authentification de base pour les appels à Solr (valeur par défaut : solr:SolrRocks).
--ssl	Utilise SSL (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:port d'un fournisseur SSL externe accessible depuis le serveur qui exécute Looker. Si aucune valeur n'est spécifiée, le serveur d'applications 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'applications Looker fournit le protocole SSL. Si votre instance Looker s'exécute sur un serveur dont l'accès à l'Internet public est limité, vous devez spécifier une adresse IP sur votre réseau interne qui est accessible par le serveur pour votre instance Looker.
--ssl-provided-externally	Obsolète. Utilisez plutôt --ssl-provided-externally-by.
--staging	Exécute le serveur en tant que préproduction. Cette option empêche votre instance de préproduction d'envoyer des rapports planifiés. Toutefois, l'instance de préproduction continuera d'exécuter les tâches planifiées et enverra des e-mails d'erreur aux propriétaires des plans planifiés en cas de problème.
--staging-override-email=<s>	Envoie les e-mails d'une instance de préproduction à cette adresse au lieu de leur destination normale.
--stereo-data-search-enabled	Activez la fonctionnalité de recherche de données stéréo (valeur par défaut : false).
--task-monitor-abandoned-query-in-seconds=<i>	Durée écoulée depuis le dernier accès à une tâche pour considérer que la tâche de requête a été abandonnée.
--task-monitor-query-startup-interval-in-seconds=<i>	Durée utilisée comme délai de grâce pendant lequel les requêtes démarrent l'exécution jusqu'à ce que le premier long sondage se produise. Il permet de laisser plus de place aux appelants avant de commencer l'interrogation.
--task-monitor-sleep-interval-in-seconds=<i>	Intervalle de veille avant que le thread de suivi des tâches puisse vérifier si les tâches sont abandonnées.
--unlimited-scheduler-threads=<i>	Nombre illimité de tâches planifiées simultanées (par défaut : 3).
--use-custom-jdbc-config	Indique si vous souhaitez utiliser la configuration personnalisée du pilote JDBC (valeur par défaut : false).
--user-db-credentials	Utilisation limitée. Les connexions peuvent utiliser des identifiants utilisateur (par défaut: false).
-v, --version	Imprime la version et quitte.

Format du fichier d'identifiants

Si vous avez remplacé la base de données de l'application par MySQL, vous avez 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 nécessite également les éléments suivants :

ssl: true

Rendre les options de démarrage permanentes

La méthode privilégié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. Il est recommandé de définir les variables d'environnement pour JAVAARGS et LOOKERARGS dans le fichier lookerstart.cfg, car elles ne seront pas écrasées lors de l'installation de nouvelles versions du script de démarrage Looker.

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"

Après avoir modifié lookerstart.cfg, vous devrez redémarrer Looker.

Étapes suivantes

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