Options de démarrage de Looker

Plusieurs paramètres de démarrage 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 les modifier.

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 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	Appliquer les migrations de bases de données au démarrage. Ne désactivez cette option que si vous appliquez des migrations séparément (par défaut: true).
--async-results-cache-time=<i>	Durée de mise en cache des résultats asynchrones (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 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 les 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 simultanés de mise en cache du rendu (par défaut: 3).
--concurrent-render-jobs=<i>	Nombre de processus de rendu PhantomJS ou Chromium simultanés (par défaut: 2).
--content-repo-enabled	La fonctionnalité 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 en Mo du magasin d'artefacts client.
-d, --internal-db-creds=<s>	Chemin d'accès au fichier YAML avec les identifiants de la base de données.
--daemonize	Exécution 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 d'origine des e-mails par défaut (par défaut: Looker <[e-mail]>).
--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 de courrier par défaut (le mot de passe sur la ligne de commande n'est pas recommandé).
--default-mailer-port=<i>	Port 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 Datadog statsd.
--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 (valeur par défaut: false)
--force-cdn	Activez de force le CDN (valeur 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 au lieu du stockage partagé.
--git-performance-logging	Active la journalisation des performances de JGit (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	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 Centre d'action 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 est réservée à une utilisation avec une base de données backend avec instance répliquée avec accès en lecture.
--internal-analytics-connection-pool-size=<i>	Nombre de connexions simultanées à la base de données susceptibles d'exécuter des requêtes du modèle d'activité du système. Cette option est réservée à une utilisation avec une base de données backend avec instance 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'a aucune incidence sur les processus ETL. La valeur par défaut est 90. Cette option est réservée à une utilisation avec une base de données backend avec instance répliqué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 de journal : text ou json (valeur 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é 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 tables PDT.
--max-scheduled-plans=<i>	Nombre maximal de plans récurrents actifs (valeur 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 régénérateur de tables PDT.
--monitoring-port=<i>	Port pour l'hébergement de la surveillance (Prometheus, ...) (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 pour 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 créés avec public_host_url au lieu de l'URL d'hôte par défaut dans Looker. L'option de démarrage doit être saisie sur 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 listé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 long poll ne vérifie si les 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 Long Poll vérifie si les 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 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 de conservation des données query_metrics dans la base de données interne (valeur par défaut: 336).
--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 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	Autorise l'exécution en mode root. Looker ne nécessite pas de privilèges racine pour un fonctionnement normal. Pour des raisons de sécurité, nous vous recommandons d'exécuter Looker dans un compte non 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 à partir du backend (valeur 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 du serveur de tunnels 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 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 (valeur par défaut: false).
--self-signup	Permet à quiconque de créer son propre compte.
--shared-storage-dir=<s>	Chemin d'accès au 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 (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 à 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 restreint, 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écution du serveur en tant que préproduction. Cette option empêche votre instance de préproduction d'envoyer des rapports planifiés. Cependant, l'instance de préproduction continuera à exécuter les tâches planifiées et enverra des e-mails d'erreur aux propriétaires du plan planifié si la tâche planifiée rencontre des problèmes.
--staging-override-email=<s>	Envoie les e-mails d'une instance de préproduction à cette adresse, et non à leur destination normale.
--stereo-data-search-enabled	Active 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 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 entre le début de l'exécution des requêtes et le premier sondage long. Cela permet de libérer de l'espace pour les appelants avant de lancer 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 les tâches sont abandonnées.
--unlimited-scheduler-threads=<i>	Nombre de tâches planifiées illimitées simultanées (par défaut: 3).
--use-custom-jdbc-config	Indique si une 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 utilisateur (par défaut: false).
-v, --version	Imprime la version et quitte la fonction.

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 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. 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 script 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 HTTPS.