Opciones de inicio de Looker

Hay varios ajustes de inicio de Looker que se pueden configurar de forma opcional en las instancias alojadas por el cliente. Si no necesitas cambiar estas opciones, puedes iniciar Looker sin ellas.

Lista de opciones de inicio

En la siguiente tabla se muestra una lista de las opciones de inicio actuales por 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> Número de alertas programadas simultáneas (valor predeterminado: 3).
--ami Obsoleto. En su lugar, usa --marketplace=aws.
--api-server-max-threads=<i> Número máximo de hilos del servidor de la API Puma.
--api-server-min-threads=<i> Número mínimo de hilos del servidor de la API de Puma.
--application-server-max-threads=<i> Número máximo de hilos del servidor de aplicaciones Puma.
--application-server-min-threads=<i> Número mínimo de hilos del servidor de aplicaciones Puma.
--apply-db-migrations Aplica migraciones de bases de datos al iniciar. Solo debes inhabilitar esta opción si vas a aplicar las migraciones por separado (valor predeterminado: true).
--async-results-cache-time=<i> Tiempo que se deben mantener en caché los resultados asíncronos (valor predeterminado: 300).
--byoid-studio-load-url=<s> URL para cargar BYOID Studio en un iframe.
--cdn-hosts=<s> Nombres de host separados por comas para el grupo de CDN (valor predeterminado: static-a.lookercdn.com,static-b.lookercdn.com).
--cipher-key-file=<s> Ruta al archivo que contiene la clave de cifrado (solo cifrado antiguo).
--cloud-trace-enabled Habilita el rastreo con las credenciales predeterminadas o con las credenciales 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 traza a Google Cloud Trace.
--cloud-trace-project-id=<s> ID del proyecto de Google al que se subirán los datos de la traza.
--cloud-trace-sample-rate=<f> La frecuencia (de 0 a 1) con la que se muestrean las trazas (valor predeterminado: 0,0).
--clustered Indica si este servidor forma parte de un clúster (valor predeterminado: false).
--concurrent-render-caching-jobs=<i> Número de procesos simultáneos de almacenamiento en caché de renderizado (valor predeterminado: 3).
--concurrent-render-jobs=<i> Número de procesos de renderización simultáneos de PhantomJS o Chromium (valor predeterminado: 2).
--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 (valor 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 las credenciales de la base de datos.
--daemonize Se ejecuta como un daemon (valor predeterminado: true).
--default-mailer-domain=<s> Dominio de correo predeterminado.
--default-mailer-fromemail=<s> Dirección de correo electrónico desde la que se envían los correos del servicio de correo predeterminado (valor predeterminado: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Nombre de host del remitente predeterminado (valor predeterminado: smtp.sendgrid.net).
--default-mailer-password=<s> Contraseña del remitente predeterminada (no se recomienda usar la contraseña en la línea de comandos).
--default-mailer-port=<i> Puerto del servicio de correo predeterminado (valor predeterminado: 587).
--default-mailer-username=<s> Nombre de usuario del correo predeterminado.
--disable-db-log Inhabilita el registro de consultas de la base de datos interna (valor predeterminado: false).
--dogstatsd-host-ip=<s> IP del host del servidor statsd de Datadog.
--dogstatsd-host-port=<i> Puerto de host del servidor de Datadog.
-e, --help Muestra esta lista de opciones de inicio.
--enable-blobstore-recryption Habilita el recifrado persistente de Blobstore en las operaciones de cambio de clave (valor predeterminado: false).
--error-emails-to=<s> Correos de error a <email address>.
--experimental-features=<s> Lista separada por comas de 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 (en lugar de Solr insertado, que es el predeterminado) (valor predeterminado: false).
--fips Habilita el cifrado FIPS-140 (valor predeterminado: false).
--force-cdn Habilita la CDN de forma obligatoria (valor predeterminado: false).
--force-cipher-key Ignora las medidas de protección de los ajustes de la clave de cifrado (solo cifrado antiguo; valor predeterminado: false).
--force-enable-pendo Habilita las guías de Pendo en instancias de marca privada o en contextos de inserción (valor predeterminado: false).
--force-error-emails Fuerza a Looker a informar de 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 usar la base de datos interna de Looker que no está sincronizada (valor predeterminado: false).
--force-no-cdn Inhabilita la CDN de forma forzada (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 vistas de páginas a objetos de seguimiento de Google Analytics adicionales.
-h, --hosted Alojado por Looker.
-H, --hostname=<s> Nombre de host para la comunicación entre nodos.
--hosted-action-hub-disabled Desactiva el centro de acción alojado.
--in-memory-cache-size=<i> Tamaño (en MB) de la caché en memoria (valor predeterminado: 200).
--integration-proxy-cert=<s> Ruta al archivo de certificado PKI del proxy de integración.
--integration-proxy-key=<s> Ruta al archivo de clave PKI de Integration Proxy.
--internal-analytics-connection-file=<s> Archivo YAML que describe la conexión de analíticas interna que aloja los datos del modelo system__activity. Esta opción solo se puede usar con una base de datos backend de réplica de lectura.
--internal-analytics-connection-pool-size=<i> Número de conexiones de base de datos simultáneas que pueden ejecutar consultas de modelos de actividad del sistema. Esta opción solo se puede usar con una base de datos backend de réplica de lectura.
--internal-analytics-retention-days=<i> Número de días que se conservarán los datos del historial en la base de datos interna. Esto no afecta a ningún proceso de ETL. El valor predeterminado es 90. Esta opción solo se puede usar con una base de datos backend de réplica de lectura.
--k8s-deployment-api-s3bucket-url=<s> URL donde este proceso de Looker puede escribir las credenciales del bucket de S3 para que se conserven como secretos de Kubernetes.
--log-format=<s> Formato de registro text o json (el valor predeterminado es text).
--log-level=<s> Nivel de registro (valor predeterminado: info).
--log-to-file Envía los resultados de registro al archivo de registro de Looker (valor predeterminado: true).
--lookml-runtime-cache-size=<i> Tamaño (en MB) de la caché de tiempo de ejecución de LookML (valor predeterminado: 200).
--loose-cipher-key-file No requiere permisos de 0600 para el archivo de clave de cifrado (solo cifrado antiguo, valor predeterminado: false).
--marketplace=<s> Se ejecuta en una instancia de Looker Marketplace.
--max-async-threads=<i> Número máximo de hilos de consulta asíncronos (valor predeterminado: 200).
--max-configurable-db-connections=<i> Número máximo de conexiones permitidas para una conexión de base de datos de cliente en la interfaz de usuario.
--max-db-connections-records=<i> Número máximo de registros de conexión permitidos en la tabla db_connection (valor predeterminado: 10.000).
--max-pdt-regen-threads=<i> Número máximo de subprocesos de regeneración de PDT.
--max-scheduled-plans=<i> Número máximo de planes programados periódicos activos (valor predeterminado: unlimited).
--max-scheduler-jitter-in-seconds=<i> Marca para repartir las ejecuciones de la programación de forma aleatoria durante el número de segundos indicado.
--max-unstreamed-limit=<i> Define el número máximo de filas que se pueden devolver en todas las consultas que no se transmiten (valor predeterminado: 100.000).
--min-pdt-regen-threads=<i> Número mínimo de subprocesos de PDT Regenerator.
--monitoring-port=<i> Puerto para alojar la monitorización (Prometheus, etc.). El valor predeterminado es 1552.
-n, --node-to-node-port=<i> Puerto para la comunicación entre nodos (valor predeterminado: 1551).
--new-cipher-key-file=<s> Ruta al archivo que contiene la nueva clave de cifrado (solo cifrado antiguo).
--on-disk-cache-size=<i> Tamaño (en MB) de la caché de disco (valor predeterminado: 2000).
-p, --port=<i> Puerto en el que se va a ejecutar (valor predeterminado: 9999).
--per-user-query-limit=<i> Limita el número de consultas simultáneas por usuario (valor predeterminado: 15).
--per-user-query-timeout=<i> Tiempo de espera por usuario para la conexión (valor predeterminado: 600).
--prefer-ipv4 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 a los administradores especificar un nombre de host public_host_url para que los URIs de retrollamada de la API Looker Action se creen con public_host_url en lugar de con la URL de host predeterminada de Looker. El valor de la opción de inicio debe ser https://<my.host.name> sin barra diagonal al final de la URL. Si se usa este método, los administradores de Looker también deben incluir en la lista de permitidas las direcciones IP de salida estáticas que se indican en la página de documentación Compartir datos a través de un centro de acciones.
-q, --queue-broker-port=<i> Puerto del broker 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 compruebe si hay resultados disponibles (valor predeterminado: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> Intervalo de suspensión inicial antes de que la API de sondeo largo compruebe si hay resultados disponibles (valor predeterminado: 0,1).
--qm-long-poll-timeout-in-seconds=<i> Tiempo de espera máximo del lado del servidor de la API de sondeo largo antes de volver al cliente (valor predeterminado: 30).
--query-manager-max-threads=<i> Número máximo de subprocesos de Gestor de consultas.
--query-manager-min-threads=<i> Número mínimo de subprocesos de Gestor de consultas.
--query-metrics-retention-hours=<i> Número de horas que se conservarán los datos de query_metrics en la base de datos interna (valor predeterminado: 336).
--queue-startup-timeout-in-seconds=<i> Tiempo en segundos que se permite la conexión a la cola al inicio (valor predeterminado: 180).
--query-task-cleanup-interval-seconds=<i> Intervalo entre las tareas de limpieza de la tabla de tareas de consulta (valor predeterminado: 600).
--query-task-persistence-duration-minutes=<i> Tiempo que transcurre después de completar una consulta para mantener las filas en la tabla de tareas de consulta (valor predeterminado: 360).
-r, --root Permite ejecutarse como raíz.

Looker no requiere privilegios de raíz para funcionar con normalidad. Por motivos de seguridad, te recomendamos que ejecutes Looker en una cuenta que no sea de administrador. Usa la opción de ejecutar como root solo cuando sea necesario, por ejemplo, si un analista de Looker te lo pide para solucionar problemas.
--redis-cache-config-file=<s> Archivo que contiene la configuración de Redis.
--report-backend-errors, --no-report-backend-errors Informa de los errores del backend (valor predeterminado: false).
--report-frontend-errors, --no-report-frontend-errors Informa de los errores del frontend (valor predeterminado: false). NOTA: Esta opción de inicio está obsoleta. En su lugar, usa la función client_monitor.
-S, --ssh-tunnel-sidecar-url=<s> La URL base que se usa para conectarse al sidecar del servidor de túnel SSH.
--scheduled-job-attempt-limit=<i> Número máximo de intentos de tareas programadas (valor predeterminado: 10).
--scheduled-job-max-age-days=<i> Antigüedad máxima de una tarea programada antes de que se elimine (valor predeterminado: 60).
--scheduler-query-limit=<i> Limita el número 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> Número de segundos que se deben esperar antes de iniciar el ejecutor de tareas (valor predeterminado: 60).
--scheduler-threads=<i> Número de tareas programadas simultáneas (valor predeterminado: 10).
--search-result-comparison Compara los resultados de Search Service con los resultados antiguos (valor predeterminado: false).
--search-service Habilita el servicio de búsqueda (valor predeterminado: false).
--search-service-ab-test Habilita la prueba A/B para Servicio de búsqueda (valor predeterminado: false).
--self-signup Permite que cualquier persona cree una cuenta.
--shared-storage-dir=<s> Ruta al almacenamiento compartido del sistema de archivos de red.
--snowplow-host=<s> Colector de Snowplow adicional.
--solr-basic-auth=<s> Credenciales de autenticación básica para las llamadas a Solr (valor predeterminado: solr:SolrRocks).
--ssl Usa SSL (valor predeterminado: true).
--ssl-ca-cert=<s> Obsoleto. En su lugar, usa --ssl-keystore.
--ssl-cert=<s> Obsoleto. En su lugar, usa --ssl-keystore.
--ssl-key=<s> Obsoleto. En su lugar, usa --ssl-keystore.
--ssl-keystore-pass-file=<s> Ruta al archivo que contiene la contraseña de ssl-keystore.
--ssl-keystore-pass=<s> Contraseña del archivo ssl-keystore.
--ssl-keystore=<s> Ruta al archivo de almacén de claves para SSL.
--ssl-provided-externally-by=<s> Proporciona el host:puerto de un proveedor de SSL externo al que se puede acceder desde el servidor que ejecuta Looker. Si no se especifica, el servidor de aplicaciones de Looker proporciona SSL.

A continuación, se muestra un ejemplo de un proxy SSL delante de un clúster de Looker:

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

Aquí tienes 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 aplicación Looker proporciona SSL. Si tu instancia de Looker se ejecuta en un servidor con acceso restringido a Internet público, tendrás que 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. En su lugar, usa --ssl-provided-externally-by.
--staging Ejecuta el servidor como staging. Esta opción evitará que tu instancia de staging envíe informes programados. Sin embargo, la instancia de staging seguirá ejecutando las tareas programadas y enviará correos de error a los propietarios de los planes programados si la tarea programada tiene algún problema.
--staging-override-email=<s> Envía correos en una instancia de staging 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 (valor predeterminado: false).
--studio-load-url=<s> URL para cargar Studio en un iframe.
--studio-one-platform-endpoint=<s> Endpoint de la API de la plataforma Studio One.
--task-monitor-abandoned-query-in-seconds=<i> Tiempo transcurrido desde el último acceso a una tarea para considerar que la tarea de consulta se ha abandonado.
--task-monitor-query-startup-interval-in-seconds=<i> Duración utilizada como periodo de gracia cuando las consultas empiezan a ejecutarse hasta que se produce la primera petición larga. De esta forma, los participantes tienen más tiempo antes de que empiece la encuesta.
--task-monitor-sleep-interval-in-seconds=<i> Intervalo de suspensión antes de que el hilo de seguimiento de tareas pueda comprobar si se han abandonado tareas.
--unification-jwt-service-account=<s> Cuenta de servicio JWT de unificación.
--unlimited-scheduler-threads=<i> Número de tareas programadas simultáneas ilimitadas (valor predeterminado: 3).
--use-custom-jdbc-config Indica si se debe usar una configuración de controlador JDBC personalizada (valor predeterminado: false).
--user-db-credentials Uso restringido. Las conexiones pueden usar credenciales por usuario (valor predeterminado: false).
-v, --version Muestra la versión y sale.

Formato de archivo de credenciales

Si has cambiado la base de datos de la aplicación a MySQL, necesitarás un archivo de credenciales llamado looker-db.yml que incluya estos ajustes:

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 debe incluir lo siguiente:

ssl: true

Hacer permanentes las opciones de inicio

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

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

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

Looker deberá reiniciarse después de hacer cambios en lookerstart.cfg.

Pasos siguientes

Una vez que hayas configurado las opciones de inicio de Looker, podrás configurar tu certificado SSL para usar HTTPS correctamente.