Opciones de inicio de Looker

Hay varios parámetros de configuración de inicio de Looker que se pueden configurar de forma opcional en instancias alojadas por el cliente. Si no necesitas cambiar estas opciones, puedes iniciar Looker sin ellas.

Lista de opciones de inicio

A continuación, se muestra una lista de las opciones de inicio actuales en orden alfabético. También puedes mostrar una lista de opciones de inicio ejecutando la secuencia de comandos de inicio de Looker con la opción --help.

Opción Descripción
--alerts-scheduler-threads=<i> Cantidad de alertas programadas simultáneas (valor predeterminado: 3).
--ami Obsoleto. Utiliza --marketplace=aws en lugar de esta función.
--api-server-max-threads=<i> Recuento máximo de subprocesos para el servidor de la API de Puma.
--api-server-min-threads=<i> Recuento mínimo de subprocesos para el servidor de la API de Puma.
--application-server-max-threads=<i> Recuento máximo de subprocesos para el servidor de aplicaciones de Puma.
--application-server-min-threads=<i> Recuento mínimo de subprocesos para el servidor de aplicaciones de Puma.
--apply-db-migrations Aplica migraciones de BD en el inicio. Inhabilítala solo si aplicas las migraciones por separado (predeterminado: true).
--async-results-cache-time=<i> El tiempo que se demora para mantener almacenados en caché los resultados asíncronos (valor predeterminado: 300).
--cdn-hosts=<s> Nombres de host separados por comas para el grupo de CDN (predeterminado: static-a.lookercdn.com,static-b.lookercdn.com).
--cipher-key-file=<s> La ruta de acceso al archivo que contiene la clave de cifrado (solo encriptación heredada).
--cloud-trace-enabled Habilita el seguimiento con las credenciales predeterminadas o con las credenciales de JSON si se proporcionan a través de cloud_trace_json_file (valor predeterminado: false).
--cloud-trace-json-file=<s> Archivo JSON que contiene las credenciales de la cuenta de servicio para subir datos de seguimiento a Google Cloud Trace.
--cloud-trace-project-id=<s> ID del proyecto de Google al que se subirán los datos de seguimiento.
--cloud-trace-sample-rate=<f> La tasa (0-1) con la que se tomarán muestras de los seguimientos. La configuración predeterminada es 1% (valor predeterminado: 0.01).
--clustered Indica si este servidor forma parte de un clúster (valor predeterminado: false).
--concurrent-render-caching-jobs=<i> Cantidad de procesos simultáneos de almacenamiento en caché de la renderización (valor predeterminado: 3).
--concurrent-render-jobs=<i> Cantidad de procesos de procesamiento simultáneos de PhantomJS o Chromium (predeterminado: 2).
--content-repo-enabled La función del repositorio de contenido está habilitada (configuración predeterminada: false).
--core-on-loopback Expone la API de Core en la interfaz de bucle invertido (predeterminado: false).
--core-port=<i> Puerto en el que se ejecutará el núcleo (valor predeterminado: 19999).
--customer-artifact-maxsize=<i> Es el tamaño máximo en MB de la tienda de artefactos del cliente.
-d, --internal-db-creds=<s> Ruta al archivo YAML con credenciales de base de datos.
--daemonize Se ejecuta como daemon (valor predeterminado: true).
--default-mailer-domain=<s> Dominio predeterminado de correo electrónico.
--default-mailer-fromemail=<s> Dirección de correo electrónico de la que provienen los correos electrónicos predeterminados de correo electrónico (predeterminada: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Nombre de host predeterminado del correo electrónico (predeterminado: smtp.sendgrid.net).
--default-mailer-password=<s> Contraseña predeterminada de correo electrónico (no se recomienda usar una contraseña en la línea de comandos).
--default-mailer-port=<i> Puerto de correo predeterminado (predeterminado: 587).
--default-mailer-username=<s> Nombre de usuario de correo electrónico predeterminado.
--disable-db-log Inhabilita el registro de consultas de BD internas (valor predeterminado: false).
--dogstatsd-host-ip=<s> IP del host del servidor de estadísticas de Datadog.
--dogstatsd-host-port=<i> Puerto del host del servidor de Datadog.
-e, --help Muestra esta lista de opciones de inicio.
--error-emails-to=<s> Envía correos electrónicos de error a <email address>.
--experimental-features=<s> Lista separada por comas de las funciones experimentales permitidas.
--experimental-routes=<s> Lista separada por comas de rutas experimentales permitidas que generan rutas con el sufijo -next.
--extension-load-url=<s> URL para cargar extensiones en un iframe seguro.
--external-solr-enabled Habilita Solr externo (a diferencia del predeterminado: Solr incorporado) (valor predeterminado: false).
--fips Habilitar la encriptación FIPS-140 (configuración predeterminada: false).
--force-cdn Habilitar CDN (predeterminado: false) de manera forzosa.
--force-cipher-key Ignora las protecciones de la configuración de la clave de cifrado (solo encriptación heredada; valor predeterminado: false).
--force-enable-pendo Habilita las guías de Pendo en instancias de etiquetas privadas o en contextos de incorporación (predeterminado: false).
--force-error-emails Fuerza a Looker a informar errores por correo electrónico (predeterminado: false).
--force-gcm-encryption OBSOLETO (esta opción ya no es necesaria).
--force-mismatched-internal-db Permite el uso de la base de datos interna de Looker dessincronizada (predeterminado: false).
--force-no-cdn Inhabilita la CDN de manera forzosa (valor predeterminado: false).
--git-hooks-use-local-path Usa una ruta de acceso local para el directorio git_hooks en lugar del almacenamiento compartido.
--git-performance-logging Habilita el registro del rendimiento de JGit (predeterminado: false).
--google-analytics-tracker-id=<s> Es el ID de seguimiento que se usa para enviar páginas vistas a herramientas de seguimiento adicionales de Google Analytics.
-h, --hosted Alojado por Looker.
-H, --hostname=<s> Nombre de host para la comunicación de nodo a nodo.
--hosted-action-hub-disabled Desactiva el centro de acciones alojado.
--in-memory-cache-size=<i> Tamaño (en MB) en la memoria caché (valor predeterminado: 200)
--integration-proxy-cert=<s> Ruta al archivo de certificado de PKI del proxy de integración.
--integration-proxy-key=<s> Ruta al archivo de claves de la PKI del proxy de integración.
--internal-analytics-connection-file=<s> Archivo YAML que describe la conexión interna de estadísticas que aloja los datos para el modelo system__activity. Esta opción solo se usa con una base de datos de backend de réplica de lectura.
--internal-analytics-connection-pool-size=<i> La cantidad de conexiones de BD simultáneas que pueden ejecutar consultas del modelo de actividad del sistema. Esta opción solo se usa con una base de datos de backend de réplica de lectura.
--internal-analytics-retention-days=<i> La cantidad de días que se retendrán los datos del historial en la base de datos interna. Esto no afecta ningún proceso de ETL. El valor predeterminado es 90. Esta opción solo se usa con una base de datos de backend de réplica de lectura.
--k8s-deployment-api-s3bucket-url=<s> URL en la que este proceso de Looker puede escribir credenciales del bucket de S3 para que se conserven como secretos de Kubernetes.
--log-format=<s> El formato de registro es text o json (valor predeterminado: text).
--log-level=<s> Nivel de registro (predeterminado: info).
--log-to-file Envía el resultado del registro al archivo de registro de Looker (predeterminado: true).
--lookml-runtime-cache-size=<i> Tamaño (en MB) de la caché del entorno de ejecución de LookML (valor predeterminado: 200).
--loose-cipher-key-file No se requieren permisos 0600 para el archivo de clave de cifrado (solo encriptación heredada; valor predeterminado: false).
--marketplace=<s> Se ejecuta en una instancia de Looker Marketplace.
--max-async-threads=<i> Cantidad máxima de subprocesos de consulta asíncrona (valor predeterminado: 200).
--max-configurable-db-connections=<i> Recuento máximo de conexiones permitido para una conexión de base de datos del cliente en la IU.
--max-db-connections-records=<i> Cantidad máxima de registros de conexión permitidos en la tabla db_connection (valor predeterminado: 10,000).
--max-pdt-regen-threads=<i> Cantidad máxima de subprocesos del regenerador de PDT.
--max-scheduled-plans=<i> Cantidad máxima de planes programados recurrentes activos (valor predeterminado: unlimited).
--max-scheduler-jitter-in-seconds=<i> El programa de la marca para compartir se ejecuta de forma aleatoria durante la cantidad de segundos especificada.
--max-unstreamed-limit=<i> Establece la cantidad máxima de filas que se pueden mostrar para todas las consultas que no se transmitieron (valor predeterminado: 100,000).
--min-pdt-regen-threads=<i> Recuento mínimo de subprocesos para el regenerador de PDT.
--monitoring-port=<i> Puerto para alojar la supervisión (Prometheus, ...) (valor predeterminado: 1552).
-n, --node-to-node-port=<i> Puerto para la comunicación de nodo a nodo (valor predeterminado: 1551)
--new-cipher-key-file=<s> Ruta al archivo que contiene la nueva clave de cifrado (solo encriptación heredada).
--on-disk-cache-size=<i> Tamaño (en MB) de la caché del disco (valor predeterminado: 2,000)
-p, --port=<i> Puerto en el que se ejecutará (valor predeterminado: 9999).
--per-user-query-limit=<i> Limita la cantidad de consultas simultáneas por usuario (valor predeterminado: 15).
--per-user-query-timeout=<i> Es el tiempo de espera por usuario que debe esperar la conexión (valor predeterminado: 600).
--prefer-ipv4 Prefiero IPv4.
--public-embed-auth-param-file=<s> Archivo de parámetro de autenticación para la autenticación pública
--public-host-url=<s> Si la función de licencia public_host_url está habilitada, esta opción permite a los administradores especificar un nombre de host public_host_url para que los URI de devolución de llamada de la API de Looker Action se construyan con public_host_url en lugar de la URL del host predeterminada en Looker. La entrada para la opción de inicio debe ser https://<my.host.name> sin una barra final en la URL. Si usan este método, los administradores de Looker también deben incluir en la lista de entidades permitidas las direcciones IP de salida estáticas que aparecen en la página de documentación Comparte datos a través de un centro de acciones.
-q, --queue-broker-port=<i> Puerto para el agente de colas (valor predeterminado: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> Intervalo de suspensión máximo antes de que la API de sondeo largo verifique si los resultados están disponibles (valor predeterminado: 1)
--qm-long-poll-sleep-interval-in-seconds=<i> El intervalo de suspensión inicial antes de que la API de sondeo largo verifique si hay resultados disponibles (valor predeterminado: 0.1).
--qm-long-poll-timeout-in-seconds=<i> Tiempo de espera máximo del servidor para la API de sondeo larga antes de que regrese al cliente (valor predeterminado: 30).
--query-manager-max-threads=<i> Recuento máximo de subprocesos para el Administrador de consultas.
--query-manager-min-threads=<i> Recuento mínimo de subprocesos para el Administrador de consultas.
--query-metrics-retention-hours=<i> La cantidad de horas que se retendrán los datos de query_metrics en la base de datos interna (valor predeterminado: 336).
--queue-startup-timeout-in-seconds=<i> La cantidad de tiempo en segundos que se debe permitir la conexión con la cola al inicio (valor predeterminado: 180).
--query-task-cleanup-interval-seconds=<i> Intervalo entre los trabajos de limpieza de tablas de tareas de consulta (valor predeterminado: 600).
--query-task-persistence-duration-minutes=<i> La cantidad de tiempo después de que se completa la consulta para mantener las filas en la tabla de tareas de la consulta (valor predeterminado: 360).
-r, --root Permite la ejecución con permisos de administrador.

Looker no requiere privilegios raíz para el funcionamiento normal. Por motivos de seguridad, te recomendamos ejecutar Looker en una cuenta que no sea raíz. Usa la opción para ejecutar como raíz solo cuando sea necesario, por ejemplo, si lo solicita un analista de Looker para solucionar problemas.
--redis-cache-config-file=<s> Archivo que contiene la configuración de Redis.
--report-backend-errors, --no-report-backend-errors Informa errores del backend (predeterminado: false).
--report-frontend-errors, --no-report-frontend-errors Informa errores desde el frontend (predeterminado: false).
-S, --ssh-tunnel-sidecar-url=<s> La URL base que se usa para conectarse al archivo adicional del servidor de túnel SSH.
--scheduled-job-attempt-limit=<i> Cantidad máxima de intentos de trabajo programados (valor predeterminado: 10).
--scheduled-job-max-age-days=<i> Antigüedad máxima de un trabajo programado antes de que se borre (valor predeterminado: 60).
--scheduler-query-limit=<i> Limita la cantidad de consultas programadas simultáneas (valor predeterminado: 10).
--scheduler-query-timeout=<i> Tiempo de espera del programador para esperar la conexión (valor predeterminado: 1200).
--scheduler-start-delay=<i> Cantidad de segundos que retrasan el inicio del ejecutor de tareas (valor predeterminado: 60).
--scheduler-threads=<i> Cantidad de tareas programadas simultáneas (valor predeterminado: 10).
--search-result-comparison Compara los resultados del Servicio de búsqueda con los heredados (valor predeterminado: false).
--search-service Habilita el Servicio de búsqueda (valor predeterminado: false).
--search-service-ab-test Habilita la prueba A/B para el servicio de Búsqueda (valor predeterminado: false).
--self-signup Permite que cualquier persona cree una cuenta para sí misma.
--shared-storage-dir=<s> Ruta al almacenamiento compartido del sistema de archivos de red.
--snowplow-host=<s> Recolector de nieve adicional
--solr-basic-auth=<s> Credenciales de autenticación básicas para llamadas a Solr (predeterminado: solr:SolrRocks).
--ssl Usa SSL (predeterminado: true).
--ssl-ca-cert=<s> Obsoleto. Utiliza --ssl-keystore en lugar de esta función.
--ssl-cert=<s> Obsoleto. Utiliza --ssl-keystore en lugar de esta función.
--ssl-key=<s> Obsoleto. Utiliza --ssl-keystore en lugar de esta función.
--ssl-keystore-pass-file=<s> Ruta al archivo que contiene la contraseña ssl-keystore.
--ssl-keystore-pass=<s> Contraseña del archivo ssl-keystore.
--ssl-keystore=<s> Ruta de acceso al archivo de almacén de claves para SSL.
--ssl-provided-externally-by=<s> Proporciona el host:port para un proveedor de SSL externo, como se puede acceder desde el servidor que ejecuta Looker. Cuando no se especifica, el servidor de la app de Looker proporciona SSL.

Este es un ejemplo de un proxy SSL frente a un clúster de Looker:

--ssl-provided-externally-by=192.168.123.13:443

Este es un ejemplo de un proveedor de SSL en el mismo host que tu instancia de Looker:

--ssl-provided-externally-by=localhost:443

Un valor nulo indica que el servidor de apps de Looker proporciona SSL. Si tu instancia de Looker se ejecuta en un servidor con acceso restringido a la Internet pública, deberás especificar una dirección IP en tu red interna a la que pueda acceder el servidor de tu instancia de Looker.
--ssl-provided-externally Obsoleto. Utiliza --ssl-provided-externally-by en lugar de esta función.
--staging Ejecuta el servidor como etapa de pruebas. Esta opción evitará que la instancia de etapa de pruebas envíe informes programados. Sin embargo, la instancia de etapa de pruebas seguirá ejecutando las tareas programadas y enviará correos electrónicos de error a los propietarios del plan programado si la tarea programada tiene algún problema.
--staging-override-email=<s> Envía correos electrónicos en una instancia de etapa de pruebas a esta dirección en lugar de a su destino normal.
--stereo-data-search-enabled Habilita la función de búsqueda de datos estéreo (predeterminado: false).
--studio-load-url=<s> URL para cargar Looker Studio en un iframe.
--task-monitor-abandoned-query-in-seconds=<i> Es la duración transcurrida desde el último acceso a una tarea que considera que se abandonó la tarea de consulta.
--task-monitor-query-startup-interval-in-seconds=<i> Es la duración que se usa como período de gracia desde el momento en que las consultas comienzan a ejecutarse hasta que se realiza el primer sondeo largo. Esto permite que haya más espacio para las personas que llaman antes de que comiencen las encuestas.
--task-monitor-sleep-interval-in-seconds=<i> El intervalo de suspensión antes de que el subproceso de seguimiento de tareas pueda verificar si se abandonan las tareas.
--unlimited-scheduler-threads=<i> Cantidad de tareas programadas ilimitadas simultáneas (valor predeterminado: 3).
--use-custom-jdbc-config Establece si se debe usar la configuración del controlador de JDBC personalizado (predeterminado: false).
--user-db-credentials Uso restringido. Las conexiones pueden usar credenciales por usuario (valor predeterminado: false).
-v, --version Imprime la versión y finaliza.

Formato de archivo de credenciales

Si cambiaste la base de datos de la aplicación a MySQL, necesitarás un archivo de credenciales llamado looker-db.yml que incluya esta configuración:

dialect: mysql
host: YOUR_HOSTNAME
username: YOUR_USERNAME
password: YOUR_PASSWORD
database: YOUR_DBNAME
port: YOUR_PORT

Si tu base de datos de MySQL requiere una conexión SSL, el archivo looker-db.yml también requiere lo siguiente:

ssl: true

Cómo configurar las opciones de inicio de manera permanente

El método preferido para que los parámetros de configuración de inicio sean permanentes es crear un archivo llamado lookerstart.cfg en el directorio de la aplicación de Looker. Este archivo se ejecutará con la secuencia de comandos de inicio de Looker que se proporcionó con tu looker.jar. Se recomienda configurar las variables de entorno de JAVAARGS y LOOKERARGS en el archivo lookerstart.cfg, ya que no se reemplazarán cuando se instalen versiones nuevas de la secuencia de comandos de inicio de Looker.

Este es un ejemplo de lookerstart.cfg, que inhabilita la SSL de Looker y la configura para que se ejecute en el puerto 8080:

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

Se deberá reiniciar Looker después de realizar cambios en lookerstart.cfg.

Próximos pasos

Después de configurar las opciones de inicio de Looker, tendrás todo listo para configurar tu certificado SSL para el HTTPS adecuado.