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 une liste d'options de démarrage en exécutant le script de démarrage de 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 base 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).
--byoid-studio-load-url=<s> URL à charger dans un iFrame pour BYOID Studio.
--cdn-hosts=<s> Noms d'hôte séparés par une virgule 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 (valeur 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 Exposer l'API Core sur l'interface de bouclage (valeur par défaut: false)
--core-port=<i> Port sur lequel exécuter le noyau (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 <noreply@lookermail.com>).
--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 du service de messagerie par défaut.
--disable-db-log Désactive la journalisation des requêtes de base de données internes (valeur 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 la recryption du Blobstore persistant sur les opérations de rekeying (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 des 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 des extensions dans un iFrame sécurisé.
--external-solr-enabled Activez Solr externe (par opposition à Solr intégré, qui est la valeur par défaut) (valeur 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 Ignore les mesures de protection pour les paramètres de clé de chiffrement (ancien chiffrement uniquement, par défaut: false).
--force-enable-pendo Active les guides Pendo sur les instances de marque privée ou dans les contextes d'intégration (valeur par défaut: false).
--force-error-emails Force Looker à signaler les erreurs par e-mail (valeur par défaut: false).
--force-gcm-encryption OBSOLÈTE (cette option n'est plus nécessaire).
--force-mismatched-internal-db Permet d'utiliser la base de données interne Looker hors synchronisation (valeur 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 à 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 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 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 consignation (par défaut: info)
--log-to-file Envoie la sortie du journal dans le 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 N'exigez pas d'autorisations 0600 pour le fichier de clé de chiffrement (ancien chiffrement uniquement, 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é 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 (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> Indicateur permettant de flouter l'exécution du calendrier de manière aléatoire pendant 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 traçées (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 le service (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 listées sur la page de documentation Partager des données via un hub d'actions.
-q, --queue-broker-port=<i> Port du courtier 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 (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 avant expiration maximal côté serveur pour l'API de requête longue avant qu'elle ne renvoie le 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 des tables de tâches de requête (par défaut: 600).
--query-task-persistence-duration-minutes=<i> Durée pendant laquelle les lignes doivent rester dans la table des tâches de requête après la fin de la 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 son fonctionnement normal. Pour des raisons de sécurité, nous vous recommandons d'exécuter Looker dans un compte autre que celui 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 demande de le faire à 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 l'option 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> Âge maximal d'une tâche planifiée 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 attendre la connexion (par défaut: 1 200).
--scheduler-start-delay=<i> Nombre de secondes de retardement avant le 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 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 à tous les utilisateurs de créer un compte pour eux-mêmes.
--shared-storage-dir=<s> Chemin d'accès à l'espace de 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:port d'un fournisseur SSL externe accessible depuis le serveur qui exécute Looker. Si cette option n'est pas spécifiée, le serveur d'application Looker fournit 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 devez spécifier une adresse IP sur votre réseau interne 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).
--studio-load-url=<s> URL permettant de charger Studio dans un iFrame.
--studio-one-platform-endpoint=<s> Point de terminaison de 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 délai de grâce lorsque les requêtes commencent à s'exécuter jusqu'à la première requête longue. Il permet de laisser plus de place aux appelants avant de commencer l'interrogation.
--task-monitor-sleep-interval-in-seconds=<i> Intervalle de mise en 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 devez 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 par 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 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 nécessite également 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 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 de 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 HTTPS approprié.