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

A continuación, se muestra la lista de 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 (configuración predeterminada: 3)
--ami Obsoleto. Utiliza --marketplace=aws en lugar de esta función.
--api-server-max-threads=<i> Cantidad máxima 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 Aplicar migraciones de bases de datos al inicio Inhabilítala solo si aplicas migraciones por separado (valor predeterminado: true).
--async-results-cache-time=<i> Es el tiempo que se mantiene en caché los resultados asíncronos (valor predeterminado: 300).
--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 de acceso al archivo que contiene la clave de cifrado (solo encriptación heredada).
--cloud-trace-enabled Habilita el seguimiento con credenciales predeterminadas o 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 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 seguimientos (valor predeterminado: 0.0).
--clustered Indica si este servidor es parte de un clúster (valor predeterminado: false).
--concurrent-render-caching-jobs=<i> Cantidad de procesos simultáneos de almacenamiento en caché de renderización (configuración predeterminada: 3).
--concurrent-render-jobs=<i> Cantidad de procesos de procesamiento simultáneos de PhantomJS o Chromium (valor predeterminado: 2).
--content-repo-enabled La función Content Repo está habilitada (configuración predeterminada: false).
--core-on-loopback Expone la API principal en la interfaz de bucle invertido (valor predeterminado: false).
--core-port=<i> Puerto para 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 de acceso al archivo YAML con las credenciales de la base de datos.
--daemonize Se ejecuta como daemon (valor predeterminado: verdadero).
--default-mailer-domain=<s> Dominio de correo electrónico predeterminado.
--default-mailer-fromemail=<s> Dirección de correo electrónico de la que provienen los correos electrónicos de correo electrónico predeterminados (valor predeterminado: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Es el nombre de host del correo electrónico predeterminado (valor predeterminado: smtp.sendgrid.net).
--default-mailer-password=<s> Contraseña de correo electrónico predeterminada (no se recomienda usar una contraseña en la línea de comandos)
--default-mailer-port=<i> Puerto de correo electrónico predeterminado (valor 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 host del servidor de Datadog.
-e, --help Muestra esta lista de opciones de inicio.
--enable-blobstore-recryption Habilita la reencriptación persistente de Blobstore en las operaciones de cambio de clave (valor predeterminado: false).
--error-emails-to=<s> 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 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 Habilita Solr externo (a diferencia del valor predeterminado, Solr incorporado) (predeterminado: false).
--fips Habilita la encriptación FIPS-140 (valor predeterminado: false).
--force-cdn Habilitar la CDN de manera forzosa (valor 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 etiqueta privada o en contextos de incorporación (valor predeterminado: false).
--force-error-emails Fuerza a Looker a informar 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 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 (valor predeterminado: false).
--google-analytics-tracker-id=<s> Es el ID de seguimiento que se debe usar para enviar vistas de página 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> Es el 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 de acceso al archivo de claves PKI del proxy de integración.
--internal-analytics-connection-file=<s> Archivo YAML que describe la conexión de estadísticas interna que aloja los datos para el modelo system__activity. Esta opción solo se debe usar 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 de modelos de actividad del sistema. Esta opción solo se debe usar 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 ETL. El valor predeterminado es 90. Esta opción solo se debe usar 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 las credenciales del bucket de S3 para que se conserven como secretos de Kubernetes.
--log-format=<s> Formato de registro que 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 (valor predeterminado: true).
--lookml-runtime-cache-size=<i> Tamaño (en MB) de la caché en tiempo de ejecución de LookML (valor predeterminado: 200).
--loose-cipher-key-file No necesitas permisos 0600 para el archivo de claves 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íncronos (valor predeterminado: 200).
--max-configurable-db-connections=<i> Recuento máximo de conexiones permitidas para una conexión a la base de datos de un 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 de 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 marcas para repartir se ejecuta de forma aleatoria durante un número determinado de segundos.
--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 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 de acceso al archivo que contiene la nueva clave de cifrado (solo encriptación heredada).
--on-disk-cache-size=<i> Tamaño (en MB) de la memoria caché del disco (valor predeterminado: 2000)
-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 la duración del tiempo de espera por usuario que se debe esperar para la conexión (valor predeterminado: 600).
--prefer-ipv4 Preferir 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 URI de devolución de llamada de la API de Looker Action se creen 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 se indican en la página de documentación Uso compartido de 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> El intervalo máximo de sueño antes de que la API de encuesta larga verifique si hay resultados disponibles (valor predeterminado: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> El intervalo de sueño inicial antes de que la API de encuesta larga verifique si hay resultados disponibles (valor predeterminado: 0.1).
--qm-long-poll-timeout-in-seconds=<i> Es el tiempo de espera máximo del servidor para la API de sondeo largo 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 deben retener los datos de query_metrics en la base de datos interna (valor predeterminado: 336).
--queue-startup-timeout-in-seconds=<i> La cantidad de segundos para permitir la conexión con la cola durante 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 completar la consulta para mantener las filas en la tabla de tareas de consulta (valor predeterminado: 360).
-r, --root Permite que se ejecute con permisos de administrador.

Looker no requiere privilegios de administrador 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 de ejecutar como raíz solo cuando sea necesario, por ejemplo, si lo solicita un analista de Looker 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 desde el backend (valor predeterminado: false).
--report-frontend-errors, --no-report-frontend-errors Informa errores desde el frontend (valor predeterminado: false).
-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 (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> Es la duración del tiempo de espera del programador para esperar la conexión (valor predeterminado: 1200).
--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 A/B para el Servicio de búsqueda (valor predeterminado: false).
--self-signup Permite que cualquiera cree una cuenta para sí mismo.
--shared-storage-dir=<s> Ruta de acceso al almacenamiento compartido del sistema de archivos de red.
--snowplow-host=<s> Recolector adicional de quitanieves.
--solr-basic-auth=<s> Credenciales de autenticación básicas para llamadas a Solr (valor predeterminado: solr:SolrRocks).
--ssl Utiliza 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 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> Es la 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 accesible desde el servidor que ejecuta Looker. Cuando no se especifica, el servidor de apps 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 el servidor pueda acceder para 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 tareas programadas y enviará correos electrónicos de error a los propietarios de 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 (valor predeterminado: false).
--studio-load-url=<s> URL para cargar Looker Studio en un iframe.
--task-monitor-abandoned-query-in-seconds=<i> Duración transcurrida desde el último acceso de una tarea para considerar la tarea de consulta 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 produce el primer sondeo largo. Ayuda a darles más espacio a los emisores 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 verificar si se abandonan las tareas.
--unlimited-scheduler-threads=<i> Cantidad de tareas programadas ilimitadas y simultáneas (valor predeterminado: 3).
--use-custom-jdbc-config Indica si se debe usar la configuración del controlador de JDBC personalizado (valor 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 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 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 manera permanente

El método preferido para hacer 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 será ejecutado por 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"

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

Próximos pasos

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