Opciones de inicio de Looker

Hay una serie de configuraciones de inicio de Looker que se pueden configurar de forma opcional. 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 si ejecutas 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áneamente (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> Cantidad mínima 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 Aplicar migraciones de bases de datos al inicio Solo inhabilita esta opción si aplicas migraciones por separado (valor predeterminado: true).
--async-results-cache-time=<i> Tiempo para mantener los resultados asíncronos almacenados en caché (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> Ruta al archivo que contiene la clave de cifrado (solo encriptación heredada).
--cloud-trace-enabled Habilita el seguimiento con credenciales predeterminadas o json si se proporcionan mediante 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> Tasa (0-1) con la que se realizan muestras de seguimientos La configuración predeterminada es del 1% (valor predeterminado: 0.01).
--clustered Si este servidor forma parte de un clúster (valor predeterminado: false).
--concurrent-render-caching-jobs=<i> Cantidad de procesos de almacenamiento en caché de procesamiento en simultáneo (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 de repositorio de contenido está habilitada (valor predeterminado: false).
--core-on-loopback Expone la API principal en la interfaz de bucle invertido (valor predeterminado: false).
--core-port=<i> Puerto en el que se ejecutará el núcleo (predeterminado: 19999)
--customer-artifact-maxsize=<i> Tamaño máximo en MB del almacén de artefactos del cliente.
-d, --internal-db-creds=<s> Ruta al archivo YAML con credenciales de DB.
--daemonize Se ejecuta como daemon (predeterminado: true).
--debug-node-modules No almacenes node_modules de forma agresiva en el paquete web (valor predeterminado: false).
--default-mailer-domain=<s> Dominio de correo predeterminado.
--default-mailer-fromemail=<s> Dirección de correo electrónico de la que proceden los correos electrónicos predeterminados (Looker <noreply@lookermail.com>:
--default-mailer-host=<s> Nombre de host del remitente predeterminado (predeterminado: smtp.sendgrid.net).
--default-mailer-password=<s> Contraseña de correo predeterminada (no se recomienda la 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 predeterminado.
--disable-db-log Inhabilita el registro de consultas de DB internas (valor predeterminado: false).
--dogstatsd-host-ip=<s> IP de 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> Correos electrónicos de error a <email address>.
--experimental-features=<s> Lista de funciones experimentales permitidas separadas por comas
--experimental-routes=<s> Lista separada por comas de las 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 Habilitar Solr externo (a diferencia del predeterminado, Solr incorporado) (predeterminado: false).
--force-cdn La habilitación forzada de CDN (valor predeterminado: false).
--force-cipher-key Se ignoran las protecciones para la configuración de claves 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 incorporados (valor predeterminado: false).
--force-error-emails Hace que Looker informe los errores por correo electrónico (valor 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 no sincronizada (valor predeterminado: false).
--force-no-cdn La fuerza inhabilita la CDN (valor predeterminado: false).
--git-hooks-use-local-path Usa una ruta local para el directorio git_hooks en lugar del almacenamiento compartido.
--git-performance-logging Habilita el registro del rendimiento de JGit (valor predeterminado: false).
--google-analytics-tracker-id=<s> ID de seguimiento que se usará 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.
--in-memory-cache-size=<i> Tamaño (en MB) de la memoria caché (valor predeterminado: 200)
--integration-proxy-cert=<s> Ruta de acceso al archivo de certificado de la PKI del proxy de integración.
--integration-proxy-key=<s> Ruta al archivo de claves de PKI del proxy de integración.
--internal-analytics-connection-file=<s> Archivo YAML que describe la conexión de estadísticas internas que aloja los datos para el modelo system__activity. Esta opción se usa solo con una base de datos de backend de réplica de lectura.
--internal-analytics-connection-pool-size=<i> La cantidad de conexiones de bases de datos simultáneas que pueden ejecutar consultas del modelo de actividad del sistema. Esta opción se usa solo 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 se usa solo 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 de bucket S3 para que sean persistentes como secretos de Kubernetes.
--log-format=<s> Formato de registro que es uno de texto, JSON.
--log-level=<s> Nivel de registro (valor 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 claves de cifrado (solo encriptación heredada, valor predeterminado: false).
--marketplace=<s> Ejecución en una instancia de Looker Marketplace
--max-async-threads=<i> Cantidad máxima de subprocesos de consulta asíncronos (predeterminado: 200)
--max-configurable-db-connections=<i> Cantidad máxima de conexiones permitida para una conexión de base de datos de clientes en la IU.
--max-pdt-regen-threads=<i> Cantidad máxima de subprocesos del regenerador PDT.
--max-scheduled-plans=<i> Cantidad máxima de planes programados recurrentes recurrentes (opción predeterminada: unlimited).
--max-unstreamed-limit=<i> Establece la cantidad máxima de filas que se pueden mostrar para todas las consultas que no se transmiten (valor predeterminado: 100,000).
--min-pdt-regen-threads=<i> Recuento mínimo de subprocesos para el regenerador de PDT.
--monitoring-port=<i> Puerto para supervisar la supervisión (Prometheus, ...) (valor predeterminado: 1552).
-n, --node-to-node-port=<i> Puerto para la comunicación de nodo a nodo (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é de 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> Duración del tiempo de espera por usuario para esperar la conexión (valor predeterminado: 600).
--prefer-ipv4 Se prefiere IPv4.
--public-embed-auth-param-file=<s> Archivo de parámetros 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 que los administradores especifiquen un nombre de host public_host_url para que los URI de devolución de llamada de la API de acción de Looker se construyan con public_host_url en lugar de la URL de host predeterminada en Looker. La entrada para la opción de inicio debe ser https://<my.host.name> sin barra final en la URL. Si usas 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 Cómo compartir datos a través de un centro de acciones.
-q, --queue-broker-port=<i> Puerto para el agente de colas (predeterminado: 61616)
--qm-long-poll-max-sleep-interval-in-seconds=<f> El intervalo de suspensión máximo antes de que la API de sondeo largo verifique si hay resultados disponibles
--qm-long-poll-sleep-interval-in-seconds=<i> Intervalo de sueño inicial antes de que la API de sondeo largo verifique si hay resultados disponibles (valor predeterminado: 30).
--qm-long-poll-timeout-in-seconds=<i> Tiempo de espera máximo del servidor para la API de sondeo largo antes de que regrese al cliente.
--query-manager-max-threads=<i> Recuento máximo de subprocesos para el Administrador de consultas
--query-manager-min-threads=<i> Cantidad mínima 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> Tiempo de segundos para permitir la conexión a la cola en el inicio (valor predeterminado: 180).
--query-task-cleanup-interval-seconds=<i> Intervalo entre los trabajos de limpieza de la tabla 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 consulta (valor predeterminado: 90).
-r, --root Permite la ejecución como raíz.

Looker no requiere privilegios de administrador 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 un analista de Looker lo solicita con fines de solución de 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 (valor predeterminado: true).
--report-frontend-errors, --no-report-frontend-errors Informa errores del frontend (valor predeterminado: true).
-S, --ssh-tunnel-sidecar-url=<s> La URL base que se usa para conectarse al archivo adicional del servidor del túnel SSH.
--scheduled-job-attempt-limit=<i> Cantidad máxima de intentos de trabajo programados (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> Duración del tiempo de espera del programador para esperar la conexión (valor predeterminado: 1,200).
--scheduler-start-delay=<i> Cantidad de segundos para retrasar 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 resultados heredados (valor predeterminado: false).
--search-service Habilita el Servicio de búsqueda (valor predeterminado: false).
--search-service-ab-test Habilita la prueba AB para el servicio de búsqueda (valor predeterminado: false).
--self-signup Permite que cualquiera cree una cuenta por sí mismo.
--shared-storage-dir=<s> Ruta de acceso al almacenamiento compartido del sistema de archivos de red.
--snowplow-host=<s> Recolector de quitanieves adicional.
--solr-basic-auth=<s> Credenciales de autenticación básicas para llamadas a Solr (valor predeterminado: solr:SolrRocks).
--ssl Usa SSL (valor 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 de ssl-keystore.
--ssl-keystore-pass=<s> Contraseña para el archivo ssl-keystore.
--ssl-keystore=<s> Ruta de acceso al archivo del almacén de claves para SSL.
--ssl-provided-externally-by=<s> Proporciona el host:port para un proveedor de SSL externo al que 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 la app de Looker proporciona SSL. Si su instancia de Looker se ejecuta en un servidor con acceso restringido a la Internet pública, deberá especificar una dirección IP en su red interna a la que pueda acceder el servidor para su 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 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 su destino normal.
--stereo-data-search-enabled Habilita la función de búsqueda de datos estéreo (valor predeterminado: false).
--super-max-query-limit Uso restringido. Establece la cantidad máxima de filas que se pueden mostrar en Explorar o los resultados de la consulta. Esto reemplaza el límite predeterminado de 5,000 filas.
--task-monitor-abandoned-query-in-seconds=<i> Es la duración transcurrido desde el último acceso a una tarea para que se considere como abandonada.
--task-monitor-query-startup-interval-in-seconds=<i> Es la duración que se usa como período de gracia cuando las consultas comienzan a ejecutarse hasta que se realiza la primera encuesta prolongada. Esto ayuda a que los emisores tengan más espacio antes de iniciar el sondeo.
--task-monitor-sleep-interval-in-seconds=<i> El intervalo de suspensión antes del subproceso de seguimiento de tareas puede comprobar si las tareas se abandonaron.
--unlimited-scheduler-threads=<i> Cantidad de tareas programadas simultáneas ilimitadas (valor predeterminado: 3).
--use-custom-jdbc-config Establece si se debe usar o no la configuración personalizada del controlador JDBC (predeterminado: false).
--user-db-credentials Uso restringido. Las conexiones pueden usar credenciales por usuario (valor predeterminado: false).
-v, --version Imprime la versión y sale.

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 MySQL requiere una conexión SSL, el archivo looker-db.yml también requiere lo siguiente:

ssl: true

Configura las opciones de inicio de forma permanente

El método preferido para hacer que la configuración de inicio sea permanente es crear un archivo llamado lookerstart.cfg en el directorio de la aplicación de Looker. La secuencia de comandos de inicio de Looker que se proporcionó con looker.jar ejecutará este archivo. El archivo lookerstart.cfg es el lugar recomendado para establecer las variables de entorno de JAVAARGS y LOOKERARGS, ya que no se reemplazarán cuando se instalen versiones nuevas de la secuencia de comandos de inicio de Looker.

A continuación, se muestra un ejemplo de lookerstart.cfg, que inhabilita el SSL de Looker y lo configura para que se ejecute en el puerto 8080:

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

Looker se debe reiniciar después de realizar cambios en lookerstart.cfg.

Próximos pasos

Una vez que hayas configurado las opciones de inicio de Looker, estarás listo para configurar tu certificado SSL para el HTTPS adecuado.