Options de démarrage de Looker

Plusieurs paramètres de démarrage de Looker peuvent éventuellement être configurés sur des 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

Vous trouverez ci-dessous la liste des options de démarrage actuelles, classées par ordre alphabétique. Vous pouvez également afficher une liste d'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 Appliquer 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 de conservation des résultats asynchrones en cache (par défaut: 300).
--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 si fournis via cloud_trace_json_file (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 du projet Google vers lequel importer les données de trace.
--cloud-trace-sample-rate=<f> Taux (0-1) avec lequel échantillonner les traces. La valeur par défaut est 1% (par défaut: 0,01).
--clustered Indique si ce serveur fait partie d'un cluster (par défaut: false).
--concurrent-render-caching-jobs=<i> Nombre de processus simultanés de mise en cache du rendu (par défaut: 3).
--concurrent-render-jobs=<i> Nombre de processus d'affichage PhantomJS ou Chromium simultanés (par défaut: 2).
--content-repo-enabled La fonctionnalité de dépôt de contenu est activée (par défaut: false).
--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 du magasin d'artefacts client en Mo.
-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 (par défaut: true).
--default-mailer-domain=<s> Domaine de messagerie par défaut.
--default-mailer-fromemail=<s> Adresse e-mail d'origine des e-mails de courrier par défaut (par défaut: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Nom d'hôte de courrier par défaut (par défaut: smtp.sendgrid.net).
--default-mailer-password=<s> Mot de passe du courrier par défaut (mot de passe sur la ligne de commande déconseillé).
--default-mailer-port=<i> Port de courrier par défaut (par défaut: 587).
--default-mailer-username=<s> Nom d'utilisateur d'e-mail 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 Datadog Statsd
--dogstatsd-host-port=<i> Port hôte du serveur Datadog.
-e, --help Affiche la liste des options de démarrage.
--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 d'itinéraires expérimentaux autorisés, séparés par une virgule, qui génèrent des itinéraires avec le suffixe -next.
--extension-load-url=<s> URL permettant de charger des extensions dans un iFrame sécurisé.
--external-solr-enabled Active le Solr externe (par opposition au Solr intégré par défaut) (par défaut: false).
--fips Activer le chiffrement FIPS-140 (par défaut: false)
--force-cdn Forcer l'activation du CDN (par défaut: false).
--force-cipher-key Ne tient pas compte des protections lié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 maisons de disques privées 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 désynchronisée (par défaut: false).
--force-no-cdn Désactivez 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 de l'espace de 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 les pages vues à d'autres outils de suivi Google Analytics.
-h, --hosted Hébergé par Looker.
-H, --hostname=<s> Nom d'hôte pour la communication nœud à nœud.
--hosted-action-hub-disabled Désactivez Action Hub hébergé.
--in-memory-cache-size=<i> Taille (en Mo) du cache 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 peut être utilisée qu'avec une base de données backend répliquée avec accès en lecture.
--internal-analytics-connection-pool-size=<i> Nombre de connexions DB simultanées pouvant exécuter des requêtes de modèle d'activité du système. Cette option ne peut être utilisée qu'avec une base de données backend répliquée avec accès en lecture.
--internal-analytics-retention-days=<i> Nombre de jours de conservation des données d'historique dans la base de données interne. Cela n'affecte aucun processus ETL. La valeur par défaut est 90. Cette option ne peut être utilisée qu'avec une base de données backend répliquée avec accès en lecture.
--k8s-deployment-api-s3bucket-url=<s> URL où ce processus Looker peut écrire les identifiants d'un bucket S3 à conserver en tant que secrets Kubernetes.
--log-format=<s> Format de 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 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ées pour une connexion à la 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 de régénération de tables PDT.
--max-scheduled-plans=<i> Nombre maximal de plans récurrents actifs actifs (par défaut: unlimited).
--max-scheduler-jitter-in-seconds=<i> La planification de l'indicateur pour lissage s'exécute de manière aléatoire sur un 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 sous forme de flux (par défaut: 100 000).
--min-pdt-regen-threads=<i> Nombre minimal de threads pour le régénérateur de PDT.
--monitoring-port=<i> Port pour l'hébergement de la surveillance (Prometheus, etc.) (par défaut: 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 (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> Délai d'attente par utilisateur avant la connexion (par défaut: 600).
--prefer-ipv4 Choisissez de préférence IPv4.
--public-embed-auth-param-file=<s> Fichier de paramètre 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 d'action Looker soient créés avec public_host_url plutôt qu'avec l'URL hôte par défaut dans Looker. L'entrée pour l'option de démarrage doit être https://<my.host.name>, sans barre oblique finale dans l'URL. Si vous utilisez cette méthode, les administrateurs Looker doivent également ajouter à la liste d'autorisation les adresses IP de sortie statiques indiquées sur la page de documentation Partager des données via un Centre d'action.
-q, --queue-broker-port=<i> Port de l'agent de service de file d'attente (par défaut: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> Intervalle maximal de sommeil avant que l'API de sondage long ne vérifie si des résultats sont disponibles (par défaut: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> Intervalle de sommeil initial avant que l'API de sondage long ne vérifie si des résultats sont disponibles (par défaut: 0,1).
--qm-long-poll-timeout-in-seconds=<i> Délai maximal côté serveur pour l'API d'interrogation longue 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 de conservation des données query_metrics dans la base de données interne (336 par défaut).
--queue-startup-timeout-in-seconds=<i> Durée en secondes pour autoriser la connexion à la file d'attente au démarrage (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 après l'exécution de la requête pour conserver les lignes dans la table des tâches de requête (par défaut: 360).
-r, --root Autorise l'exécution en mode root.

Looker n'a pas besoin de droits d'administrateur pour fonctionner normalement. Pour des raisons de sécurité, nous vous recommandons d'exécuter Looker sur un compte non racine. Utilisez l'option d'exécution en mode root uniquement lorsque cela est nécessaire, par exemple si un analyste Looker 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 depuis le backend (par défaut: false).
--report-frontend-errors, --no-report-frontend-errors Signale les erreurs à partir de l'interface (par défaut: false).
-S, --ssh-tunnel-sidecar-url=<s> URL de base utilisée pour se connecter au side-car serveur du tunnel SSH.
--scheduled-job-attempt-limit=<i> Nombre maximal de tentatives de jobs planifiés (par défaut: 10).
--scheduled-job-max-age-days=<i> Ancienneté maximale d'un job planifié 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 programmeur avant 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 anciens résultats (par défaut: false).
--search-service Active le service de recherche (valeur par défaut: false).
--search-service-ab-test Activer le test AB pour le service de recherche (par défaut: false)
--self-signup Permet à n'importe quel utilisateur 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 en réseau.
--snowplow-host=<s> Récupérateur de chasse-neige en plus.
--solr-basic-auth=<s> Identifiants d'authentification de base pour les appels à Solr (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 pour le 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 pour un fournisseur SSL externe, tel qu'il est accessible depuis le serveur qui exécute Looker. Si aucune valeur n'est spécifiée, le serveur d'applications Looker fournit la norme 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 la norme SSL. Si votre instance Looker s'exécute sur un serveur avec un accès restreint à l'Internet public, vous devez spécifier une adresse IP sur votre réseau interne à laquelle le serveur peut accéder 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 continue d'exécuter les tâches planifiées et envoie des e-mails d'erreur aux propriétaires du plan planifié en cas de problème lié à la tâche planifiée.
--staging-override-email=<s> Envoie des e-mails sur une instance de préproduction à cette adresse plutôt qu'à leur destination normale.
--stereo-data-search-enabled Activer la fonctionnalité de recherche de données stéréo (par défaut: false).
--studio-load-url=<s> URL permettant de charger Looker Studio dans un iFrame.
--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 entre le début de l'exécution des requêtes et le début du premier long sondage. Cela laisse plus de place aux appelants avant de lancer la recherche.
--task-monitor-sleep-interval-in-seconds=<i> Intervalle de sommeil avant que le thread de suivi des tâches puisse vérifier si les tâches sont abandonnées.
--unlimited-scheduler-threads=<i> Nombre de tâches planifiées simultanées illimitées (par défaut: 3).
--use-custom-jdbc-config Indique si la configuration de pilote JDBC personnalisée doit être utilisé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 des 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 requiert é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. Le fichier lookerstart.cfg est l'endroit recommandé pour définir les variables d'environnement pour JAVAARGS et LOOKERARGS, car elles ne seront pas écrasées lors de l'installation de nouvelles versions du script de démarrage Looker.

Voici un exemple de lookerstart.cfg, qui désactive le SSL de Looker et le configure pour s'exécuter sur le port 8080:

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

Looker devra redémarrer après avoir apporté des modifications à lookerstart.cfg.

Étapes suivantes

Après avoir configuré les options de démarrage de Looker, vous pouvez configurer votre certificat SSL pour le protocole HTTPS.