Options de démarrage de Looker

Il existe un certain nombre de paramètres de démarrage de Looker qui peuvent être configurés 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 fournit une 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 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 de conservation des résultats asynchrones 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 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 à l'aide de --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) 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 noyau (par défaut : 19999).
--customer-artifact-maxsize=<i>	Taille maximale en Mo du magasin d'artefacts du 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).
--db-migrations-kill-timeout=<i>	Délai avant expiration de l'arrêt des migrations de base de données, en secondes (par défaut : 480).
--db-migrations-lock-wait-timeout=<i>	Délai d'attente de verrouillage pour les migrations de bases de données, en secondes (par défaut : 180).
--db-migrations-monitor-cutoff=<i>	Heure limite pour la surveillance des migrations de bases de données internes, en secondes (par défaut : 2592000).
--db-migrations-wait-timeout=<i>	Délai d'attente pour les migrations de bases de données, en secondes (par défaut : 720).
--default-mailer-domain=<s>	Domaine de messagerie par défaut.
--default-mailer-fromemail=<s>	Adresse e-mail d'où proviennent les e-mails de l'outil d'envoi d'e-mails par défaut (par défaut : Looker <[e-mail]>).
--default-mailer-host=<s>	Nom d'hôte du programme de messagerie par défaut (par défaut : smtp.sendgrid.net).
--default-mailer-password=<s>	Mot de passe de l'outil de messagerie 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 par défaut du service de messagerie.
--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 de l'hôte du serveur Datadog.
-e, --help	Affiche cette liste d'options de démarrage.
--enable-blobstore-recryption	Activez le rechiffrement du Blobstore persistant lors des opérations de rechiffrement (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 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	Activez Solr externe (par opposition à Solr intégré par défaut) (par défaut : false).
--fips	Activer le chiffrement FIPS-140 (par défaut : false).
--force-cdn	Activez de force le CDN (par défaut : false).
--force-cipher-key	Ignore les mesures de protection pour les paramètres de clé de chiffrement (chiffrement ancien uniquement, valeur par défaut : false).
--force-enable-pendo	Active les guides Pendo sur les instances de marque de distributeur 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ésactiver 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 d'un 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 à des outils de suivi 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 n'est à utiliser 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 n'est à utiliser qu'avec une base de données backend d'instance répliquée avec accès en lecture.
--internal-data-apps-on-gcs	Permet aux extensions d'application de données de récupérer des éléments d'exécution depuis Google Cloud Storage (interne/Googlers uniquement).
--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 n'est à utiliser 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 pour qu'ils soient conservés en tant que secrets Kubernetes.
--load-chronicle-dialect	Indique si le dialecte intégré de Chronicle doit être chargé (par défaut : false).
--log-format=<s>	Format de journal, qui est soit text, soit json (par défaut : text).
--log-frontend-errors	Enregistrez les détails des erreurs du frontend dans le fichier journal du client (par défaut : false).
--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).
--lookerdb-query-timeout=<i>	Délai avant expiration des requêtes de base de données interne Looker en ms (par défaut : 0).
--lookml-runtime-cache-size=<i>	Taille (en Mo) du cache d'exécution LookML (par défaut : 200).
--loose-cipher-key-file	Ne pas exiger d'autorisations 0600 pour le fichier de clé de chiffrement (chiffrement ancien uniquement, par défaut : false).
--marketplace=<s>	Exécution dans une instance Marketplace Looker.
--max-async-threads=<i>	Nombre maximal de threads de requête asynchrone (par défaut : 200).
--max-configurable-db-connections=<i>	Nombre maximal de connexions autorisé pour une connexion à une 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 programmés récurrents actifs (par défaut : unlimited).
--max-scheduler-jitter-in-seconds=<i>	Option permettant de répartir de manière aléatoire les exécutions planifiées 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 streaming (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 la surveillance de l'hébergement (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 (chiffrement ancien uniquement).
--on-disk-cache-size=<i>	Taille (en Mo) du cache disque (par défaut : 2 000).
-p, --port=<i>	Port sur lequel l'exécuter (par défaut : 9999).
--per-user-query-limit=<i>	Limite le nombre de requêtes simultanées par utilisateur, par connexion et par nœud sur l'instance Looker (valeur par défaut : 15). Si une valeur est fournie pour le paramètre Nombre maximal de requêtes simultanées par utilisateur pour cette connexion, elle remplacera la valeur per-user-query-limit pour la connexion. Notez que le paramètre Max concurrent queries per user for this connection (Nombre maximal de requêtes simultanées par utilisateur pour cette connexion) s'applique par utilisateur et par connexion, mais pas par nœud. Pour en savoir plus, consultez la page de documentation Connecter Looker à votre base de données.
--per-user-query-timeout=<i>	Durée du délai avant expiration par utilisateur pour attendre 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 de l'hôte par défaut dans Looker. L'entrée de l'option de démarrage doit être https://, 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 du courtier 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 d'interrogation longue 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 d'interrogation longue 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 avant expiration de l'API d'interrogation longue avant qu'elle ne renvoie 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 (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 jobs de nettoyage de la table des tâches de requête (par défaut : 600).
--query-task-persistence-duration-minutes=<i>	Durée pendant laquelle les lignes sont conservées dans la table des tâches de requête après l'exécution 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 d'accès root pour un fonctionnement normal. 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 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.
--regionalised-prod-byoid-studio-load-url=<s>	URL de production avec un espace réservé pour la région afin de charger Studio BYOID dans un iFrame.
--regionalised-prod-studio-load-url=<s>	URL de production avec un espace réservé pour la région afin de charger Studio.
--regionalised-prod-studio-one-platform-endpoint=<s>	Point de terminaison de production avec région d'espace réservé pour l'API Studio One Platform.
--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 le flag de fonctionnalité 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 programmées simultanées (par défaut : 10).
--scheduler-query-timeout=<i>	Durée du délai avant expiration du programmeur pour attendre la connexion (par défaut : 1 200).
--scheduler-start-delay=<i>	Délai en secondes avant le 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 (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 (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'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'application 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 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 qu'environnement de préproduction. Cette option empêchera 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 avec la tâche planifiée.
--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 (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 pour qu'une tâche considère 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 la première interrogation longue. Cela permet de donner 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 des tâches sont abandonnées.
--unification-jwt-service-account=<s>	Compte de service JWT d'unification.
--unlimited-scheduler-threads=<i>	Nombre de tâches planifiées illimitées simultanées (par défaut : 3).
--url-flags-override	Permet de remplacer les flags de fonctionnalité à l'aide d'un paramètre de requête d'URL.
--use-custom-jdbc-config	Indique si vous souhaitez 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 de 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 inclure les éléments suivants :

ssl: true

Rendre les options de démarrage permanentes

La méthode recommandée pour rendre permanents les paramètres de configuration de démarrage 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 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"

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

Étapes suivantes

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