Opciones de inicio de Looker

Hay varios parámetros de configuración de inicio de Looker que se pueden establecer 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 proporciona 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> Es el recuento máximo de subprocesos para el servidor de la API de Puma.
--api-server-min-threads=<i> Es la cantidad mínima de subprocesos para el servidor de la API de Puma.
--application-server-max-threads=<i> Es el recuento máximo de subprocesos para el servidor de aplicaciones Puma.
--application-server-min-threads=<i> Es la cantidad mínima de subprocesos para el servidor de aplicaciones de Puma.
--apply-db-migrations Aplica migraciones de base de datos al inicio. Inhabilítala solo si aplicas migraciones por separado (opción predeterminada: true).
--async-results-cache-time=<i> Es el período durante el que se mantienen los resultados asíncronos almacenados en caché (el valor predeterminado es 300).
--byoid-studio-load-url=<s> Es la URL para cargar BYOID Studio en un iframe.
--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> Es 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 las credenciales JSON si se proporcionan con --cloud-trace-json-file (predeterminado: false).
--cloud-trace-json-file=<s> Es el archivo JSON que contiene las credenciales de cuenta de servicio para subir datos de seguimiento a Google Cloud Trace.
--cloud-trace-project-id=<s> Es el ID del proyecto de Google al que se subirán los datos de seguimiento.
--cloud-trace-sample-rate=<f> Es la tasa (0-1) con la que se muestrean los seguimientos (predeterminada: 0.0).
--clustered Indica 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 renderización simultáneos (predeterminado: 3).
--concurrent-render-jobs=<i> Es la cantidad de procesos de renderización simultáneos de PhantomJS o Chromium (valor predeterminado: 2).
--core-on-loopback Expone la API de Core en la interfaz de bucle invertido (el valor predeterminado es false).
--core-port=<i> Es el puerto en el que se ejecutará el núcleo (predeterminado: 19999).
--customer-artifact-maxsize=<i> Es el tamaño máximo en MB del almacén de artefactos del cliente.
-d, --internal-db-creds=<s> Ruta de acceso al archivo YAML con las credenciales de la base de datos.
--daemonize Se ejecuta como daemon (el valor predeterminado es verdadero).
--db-migrations-kill-timeout=<i> Es el tiempo de espera de finalización para las migraciones de bases de datos en segundos (predeterminado: 480).
--db-migrations-lock-wait-timeout=<i> Tiempo de espera de bloqueo para las migraciones de la base de datos en segundos (predeterminado: 180).
--db-migrations-monitor-cutoff=<i> Es el horario límite para supervisar las migraciones de bases de datos internas en segundos (el valor predeterminado es 2592000).
--db-migrations-wait-timeout=<i> Es el tiempo de espera para las migraciones de la base de datos en segundos (el valor predeterminado es 720).
--default-mailer-domain=<s> Es el dominio predeterminado del remitente.
--default-mailer-fromemail=<s> Es la dirección de correo electrónico de la que provienen los correos electrónicos del remitente predeterminado (valor predeterminado: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Es el nombre de host del programa de correo predeterminado (predeterminado: smtp.sendgrid.net).
--default-mailer-password=<s> Contraseña predeterminada del programa de correo (no se recomienda usar la contraseña en la línea de comandos).
--default-mailer-port=<i> Es el puerto predeterminado del sistema de correo (predeterminado: 587).
--default-mailer-username=<s> Es el nombre de usuario predeterminado del sistema de correo.
--disable-db-log Inhabilita el registro de consultas internas de la base de datos (predeterminado: false).
--dogstatsd-host-ip=<s> Es la IP del host del servidor de statsd de Datadog.
--dogstatsd-host-port=<i> Es el puerto del host del servidor de Datadog.
-e, --help Muestra esta lista de opciones de inicio.
--enable-blobstore-recryption Habilita la reencriptación de Blobstore persistente en las operaciones de cambio de clave (predeterminado: false).
--error-emails-to=<s> Se enviarán 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> Es la URL para cargar extensiones en un iframe seguro.
--external-solr-enabled Habilita Solr externo (en lugar del Solr incorporado predeterminado) (predeterminado: false).
--fips Habilita la encriptación de FIPS-140 (predeterminado: false).
--force-cdn Habilita la CDN de forma forzosa (predeterminado: false).
--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 marca propia o en contextos de incorporación (predeterminado: false).
--force-error-emails Obliga 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 desincronizada (predeterminado: false).
--force-no-cdn Inhabilita la CDN de manera forzosa (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 usará para enviar vistas de página a herramientas de seguimiento de Google Analytics adicionales.
-h, --hosted Alojado por Looker.
-H, --hostname=<s> Es el nombre de host para la comunicación de nodo a nodo.
--hosted-action-hub-disabled Desactivar el centro de acciones alojado
--in-memory-cache-size=<i> Es el tamaño (en MB) de la caché en la memoria (predeterminado: 200).
--integration-proxy-cert=<s> Ruta de acceso al archivo de certificado de PKI del proxy de integración.
--integration-proxy-key=<s> Ruta de acceso al archivo de claves de PKI del proxy de integración.
--internal-analytics-connection-file=<s> Es un archivo YAML que describe la conexión de estadísticas internas que aloja los datos del modelo de 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> Es la cantidad de conexiones de base de datos simultáneas que pueden ejecutar consultas de modelos de actividad del sistema. Esta opción solo se usa con una base de datos de backend de réplica de lectura.
--internal-data-apps-on-gcs Permite que las extensiones de apps de datos recuperen recursos de tiempo de ejecución de Google Cloud Storage (solo para uso interno y de Googlers).
--internal-analytics-retention-days=<i> Es la cantidad de días que se conservarán los datos históricos 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> Es la URL en la que este proceso de Looker puede escribir credenciales del bucket de S3 para que se conserven como Secrets de Kubernetes.
--load-chronicle-dialect Indica si se debe cargar el dialecto integrado de Chronicle (valor predeterminado: false).
--log-format=<s> Formato de registro que puede ser text o json (predeterminado: text).
--log-frontend-errors Registra los detalles de los errores del frontend en el archivo de registro del cliente (predeterminado: false).
--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).
--lookerdb-query-timeout=<i> Es el valor del tiempo de espera para las consultas de la base de datos interna de Looker en ms (el valor predeterminado es 0).
--lookml-runtime-cache-size=<i> Es el tamaño (en MB) de la caché del entorno de ejecución de LookML (el valor predeterminado es 200).
--loose-cipher-key-file No requiere 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> Es la cantidad máxima de subprocesos de consulta asíncronos (el valor predeterminado es 200).
--max-configurable-db-connections=<i> Es la cantidad máxima de conexiones permitidas para una conexión de base de datos de cliente en la IU.
--max-db-connections-records=<i> Es la cantidad máxima de registros de conexión permitidos en la tabla db_connection (el valor predeterminado es 10000).
--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 (predeterminado: unlimited).
--max-scheduler-jitter-in-seconds=<i> Es la marca para distribuir las ejecuciones de programación de forma aleatoria durante la cantidad de segundos determinada.
--max-unstreamed-limit=<i> Establece la cantidad máxima de filas que se pueden devolver para todas las consultas que no se transmiten (valor predeterminado: 100,000).
--min-pdt-regen-threads=<i> Cantidad mínima de subprocesos para el regenerador de PDT.
--monitoring-port=<i> Es el puerto para alojar la supervisión (Prometheus, etcétera) (predeterminado: 1552).
-n, --node-to-node-port=<i> Es el puerto para la comunicación de nodo a nodo (predeterminado: 1551).
--new-cipher-key-file=<s> Es la ruta de acceso al archivo que contiene la clave de cifrado nueva (solo para la encriptación heredada).
--on-disk-cache-size=<i> Es el tamaño (en MB) de la memoria caché del disco (el valor predeterminado es 2000).
-p, --port=<i> Es el puerto en el que se ejecutará (predeterminado: 9999).
--per-user-query-limit=<i> Limita la cantidad de consultas simultáneas por usuario, por conexión y por nodo en la instancia de Looker (el valor predeterminado es 15). En el caso de una conexión, si se proporciona un valor para el parámetro de configuración Cantidad máx. de consultas simultáneas por usuario para esta conexión, este valor anulará el per-user-query-limit de la conexión. Ten en cuenta que el parámetro de configuración Cantidad máx. de consultas simultáneas por usuario para esta conexión se aplica por usuario y por conexión, pero no por nodo. Consulta la página de documentación Conecta Looker a tu base de datos para obtener más información.
--per-user-query-timeout=<i> Es la duración del tiempo de espera por usuario para esperar la conexión (el valor predeterminado es 600).
--prefer-ipv4 Preferir IPv4.
--public-embed-auth-param-file=<s> Es el archivo de parámetros de autenticación para la autenticación pública.
--public-host-url=<s> Si la función de licencia de public_host_url está habilitada, esta opción permite que los administradores especifiquen un nombre de host de public_host_url para que los URI de devolución de llamada de la API de Looker Action se construyan con el public_host_url en lugar de la URL de host predeterminada en Looker. La entrada para la opción de inicio debe ser https:// 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 entidades permitidas las direcciones IP de salida estáticas que se indican en la página de documentación Cómo compartir datos a través de un centro de acciones.
-q, --queue-broker-port=<i> Es el puerto para el agente de cola (valor predeterminado: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> Es el intervalo de suspensión máximo antes de que la API de sondeo largo verifique si hay resultados disponibles (el valor predeterminado es 1).
--qm-long-poll-sleep-interval-in-seconds=<i> Es 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 largo antes de que vuelva al cliente (predeterminado: 30).
--query-manager-max-threads=<i> Es la cantidad máxima de subprocesos para el administrador de consultas.
--query-manager-min-threads=<i> Es la cantidad mínima de subprocesos para el administrador de consultas.
--query-metrics-retention-hours=<i> Es la cantidad de horas que se conservarán los datos de query_metrics en la base de datos interna (el valor predeterminado es 336).
--queue-startup-timeout-in-seconds=<i> Es el tiempo en segundos que se permite la conexión a la cola durante el inicio (el valor predeterminado es 180).
--query-task-cleanup-interval-seconds=<i> Es el intervalo entre los trabajos de limpieza de la tabla de tareas de consulta (el valor predeterminado es 600).
--query-task-persistence-duration-minutes=<i> Es la cantidad de tiempo que se conservan las filas en la tabla de tareas de consulta después de que se completa la consulta (el valor predeterminado es 360).
-r, --root Permite la ejecución como raíz.

Looker no requiere privilegios de raíz para el funcionamiento normal. Por motivos de seguridad, te recomendamos que ejecutes 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 para solucionar problemas.
--redis-cache-config-file=<s> Es el archivo que contiene la configuración de Redis.
--regionalised-prod-byoid-studio-load-url=<s> Es la URL de producción con la región de marcador de posición para cargar BYOID Studio en un iframe.
--regionalised-prod-studio-load-url=<s> URL de producción con marcador de posición de región para cargar Studio.
--regionalised-prod-studio-one-platform-endpoint=<s> Es el extremo de producción con la región de marcador de posición para la API de Studio One Platform.
--report-backend-errors, --no-report-backend-errors Informa errores del backend (predeterminado: false).
--report-frontend-errors, --no-report-frontend-errors Informa errores de la interfaz (predeterminado: false). NOTA: Esta opción de inicio está obsoleta. En su lugar, usa la marca de función client_monitor.
-S, --ssh-tunnel-sidecar-url=<s> Es la URL base que se usa para conectarse al sidecar del servidor de túnel SSH.
--scheduled-job-attempt-limit=<i> Es la cantidad máxima de intentos de trabajos programados (el valor predeterminado es 10).
--scheduled-job-max-age-days=<i> Es la antigüedad máxima de un trabajo programado antes de que se borre (el valor predeterminado es 60).
--scheduler-query-limit=<i> Limita la cantidad de consultas programadas simultáneas (el valor predeterminado es 10).
--scheduler-query-timeout=<i> Es la duración del tiempo de espera del programador para esperar la conexión (el valor predeterminado es 1200).
--scheduler-start-delay=<i> Es la cantidad de segundos que se debe retrasar el inicio del ejecutor de tareas (el valor predeterminado es 60).
--scheduler-threads=<i> Cantidad de tareas programadas simultáneas (predeterminada: 10).
--search-result-comparison Compara los resultados del servicio de búsqueda con los resultados heredados (predeterminado: false).
--search-service Habilita el servicio de búsqueda (predeterminado: false).
--search-service-ab-test Habilita la prueba A/B para el servicio de búsqueda (predeterminado: false).
--self-signup Permite que cualquier persona cree una cuenta para sí misma.
--shared-storage-dir=<s> Es la ruta de acceso al almacenamiento compartido del sistema de archivos de red.
--snowplow-host=<s> Recopilador adicional de Snowplow.
--solr-basic-auth=<s> Son las credenciales de autenticación básica para las llamadas a Solr (configuración predeterminada: 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> Es la ruta de acceso al archivo que contiene la contraseña de 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:puerto 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.

A continuación, se muestra 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 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 tu 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 de los planes programados 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 (predeterminado: false).
--studio-load-url=<s> Es la URL para cargar Studio en un iframe.
--studio-one-platform-endpoint=<s> Es el extremo de la API de Studio One Platform.
--task-monitor-abandoned-query-in-seconds=<i> Es la duración transcurrida desde el último acceso para que una tarea considere que la tarea de consulta se abandonó.
--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 produce el primer sondeo largo. Ayuda a dar más espacio a los participantes antes de iniciar la encuesta.
--task-monitor-sleep-interval-in-seconds=<i> Es el intervalo de suspensión antes de que el subproceso de seguimiento de tareas pueda verificar si se abandonaron las tareas.
--unification-jwt-service-account=<s> Cuenta de servicio de JWT de unificación.
--unlimited-scheduler-threads=<i> Cantidad de tareas programadas simultáneas ilimitadas (predeterminada: 3).
--url-flags-override Permite anular las marcas de función con un parámetro de consulta de URL.
--use-custom-jdbc-config Indica si se debe usar la configuración personalizada del controlador de JDBC (predeterminado: false).
--user-db-credentials Uso restringido. Las conexiones pueden usar credenciales por usuario (predeterminado: false).
-v, --version Imprime la versión y finaliza.

Formato del 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 estos parámetros de 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 hacer permanentes las opciones de inicio

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. El archivo lookerstart.cfg es el lugar recomendado para establecer variables de entorno para JAVAARGS y LOOKERARGS, 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 el SSL de Looker y lo configura para que se ejecute en el puerto 8080:

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

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

Próximos pasos

Después de configurar las opciones de inicio de Looker, ya puedes configurar tu certificado SSL para HTTPS adecuado.