Looker 시작 옵션

고객 호스팅 인스턴스에서 원하는 경우 여러 Looker 시작 설정을 구성할 수 있습니다. 이러한 옵션을 변경할 필요가 없는 경우 옵션 없이 Looker를 시작할 수 있습니다.

시작 옵션 목록

다음 표에서는 현재 시작 옵션의 알파벳순 목록을 제공합니다. --help 옵션과 함께 Looker 시작 스크립트를 실행하여 시작 옵션 목록을 표시할 수도 있습니다.

옵션 설명
--alerts-scheduler-threads=<i> 동시에 예약된 알림 수(기본값: 3)
--ami 지원 중단되었습니다. 대신 --marketplace=aws를 사용하세요.
--api-server-max-threads=<i> Puma API 서버의 최대 스레드 수입니다.
--api-server-min-threads=<i> Puma API 서버의 최소 스레드 수입니다.
--application-server-max-threads=<i> Puma 애플리케이션 서버의 최대 스레드 수입니다.
--application-server-min-threads=<i> Puma 애플리케이션 서버의 최소 스레드 수입니다.
--apply-db-migrations 시작 시 DB 마이그레이션을 적용합니다. 별도로 마이그레이션을 적용하는 경우에만 사용 중지하세요(기본값: true).
--async-results-cache-time=<i> 비동기 결과를 캐시할 기간입니다(기본값: 300).
--byoid-studio-load-url=<s> BYOID Studio를 iframe에 로드하기 위한 URL입니다.
--cdn-hosts=<s> CDN 풀의 쉼표로 구분된 호스트 이름입니다(기본값: static-a.lookercdn.com,static-b.lookercdn.com).
--cipher-key-file=<s> 암호화 키가 포함된 파일 경로입니다(기존 암호화만 해당).
--cloud-trace-enabled cloud_trace_json_file을 통해 제공되는 경우 기본 사용자 인증 정보 또는 json 사용자 인증 정보를 사용한 추적을 사용 설정합니다(기본값: false).
--cloud-trace-json-file=<s> trace 데이터를 Google Cloud Trace에 업로드할 서비스 계정 사용자 인증 정보가 포함된 JSON 파일입니다.
--cloud-trace-project-id=<s> trace 데이터를 업로드할 Google 프로젝트 ID입니다.
--cloud-trace-sample-rate=<f> trace를 샘플링하는 속도(0-1)입니다(기본값: 0.0).
--clustered 이 서버가 클러스터의 일부인지 여부입니다(기본값: false).
--concurrent-render-caching-jobs=<i> 동시 렌더링 캐싱 프로세스 수입니다(기본값: 3).
--concurrent-render-jobs=<i> 동시 PhantomJS 또는 Chromium 렌더링 프로세스 수입니다(기본값: 2).
--core-on-loopback 루프백 인터페이스에 코어 API를 노출합니다(기본값: false).
--core-port=<i> 코어를 실행할 포트입니다(기본값: 19999).
--customer-artifact-maxsize=<i> 고객 아티팩트 저장소의 최대 크기(MB)입니다.
-d, --internal-db-creds=<s> DB 사용자 인증 정보가 있는 YAML 파일의 경로입니다.
--daemonize 데몬으로 실행됩니다(기본값: true).
--default-mailer-domain=<s> 기본 메일러 도메인입니다.
--default-mailer-fromemail=<s> 기본 메일러가 보낸 이메일 주소입니다(기본값: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> 기본 메일러 호스트 이름입니다(기본값: smtp.sendgrid.net).
--default-mailer-password=<s> 기본 메일러 비밀번호입니다(명령줄에서는 비밀번호가 권장되지 않음).
--default-mailer-port=<i> 기본 메일러 포트입니다(기본값: 587).
--default-mailer-username=<s> 기본 메일러 사용자 이름입니다.
--disable-db-log 내부 DB 쿼리 로깅을 사용 중지합니다(기본값: false).
--dogstatsd-host-ip=<s> Datadog statsd 서버 호스트 IP입니다.
--dogstatsd-host-port=<i> Datadog 서버 호스트 포트입니다.
-e, --help 시작 옵션 목록을 표시합니다.
--enable-blobstore-recryption 키 갱신 작업에 영구 Blobstore 재암호화를 사용 설정합니다(기본값: false).
--error-emails-to=<s> <email address>에 대한 오류 이메일입니다.
--experimental-features=<s> 허용된 실험용 기능을 쉼표로 구분한 목록입니다.
--experimental-routes=<s> -next 서픽스가 있는 경로를 생성하는 실험용으로 허용된 경로에서 쉼표로 구분된 목록입니다.
--extension-load-url=<s> 보안 iframe에 확장 프로그램을 로드하는 URL입니다.
--external-solr-enabled 외부 Solr(기본값과 반대 - 삽입된 Solr)을 사용 설정합니다(기본값: false).
--fips FIPS-140 암호화를 사용 설정합니다(기본값: false).
--force-cdn CDN을 강제로 사용 설정합니다(기본값: false).
--force-cipher-key 암호화 키 설정의 보호 장치를 무시합니다(기존 암호화만 해당, 기본값: false).
--force-enable-pendo 비공개 라벨 인스턴스 또는 임베딩 컨텍스트에서 Pendo 가이드를 사용 설정합니다(기본값: false).
--force-error-emails Looker가 이메일을 통해 오류를 보고하도록 합니다(기본값: false).
--force-gcm-encryption 지원 중단됨(이 옵션은 더 이상 필요하지 않음)
--force-mismatched-internal-db 동기화되지 않은 Looker 내부 DB를 사용할 수 있습니다(기본값: false).
--force-no-cdn CDN을 강제로 사용 중지합니다(기본값: false).
--git-hooks-use-local-path 공유 스토리지 대신 git_hooks 디렉터리의 로컬 경로를 사용합니다.
--git-performance-logging JGit 성능 로깅을 사용 설정합니다(기본값: false).
--google-analytics-tracker-id=<s> 추가 Google 애널리틱스 추적기에 페이지 조회수를 보내는 데 사용할 추적 ID입니다.
-h, --hosted Looker에서 호스팅되었습니다.
-H, --hostname=<s> 노드 간 통신의 호스트 이름입니다.
--hosted-action-hub-disabled 호스팅된 작업 허브를 사용 중지합니다.
--in-memory-cache-size=<i> 메모리 캐시의 크기(MB)입니다(기본값: 200).
--integration-proxy-cert=<s> 통합 프록시 PKI 인증서 파일의 경로입니다.
--integration-proxy-key=<s> 통합 프록시 PKI 키 파일의 경로입니다.
--internal-analytics-connection-file=<s> system__activity 모델의 데이터를 호스팅하는 내부 애널리틱스 연결을 설명하는 YAML 파일입니다. 이 옵션은 읽기 복제본 백엔드 데이터베이스에만 사용됩니다.
--internal-analytics-connection-pool-size=<i> 시스템 활동 모델 쿼리를 실행할 수 있는 동시 DB 연결 수입니다. 이 옵션은 읽기 복제본 백엔드 데이터베이스에만 사용됩니다.
--internal-analytics-retention-days=<i> 내부 데이터베이스의 기록 데이터를 보관할 일수입니다. ETL 프로세스에는 영향을 주지 않습니다. 기본값은 90입니다. 이 옵션은 읽기 복제본 백엔드 데이터베이스에만 사용됩니다.
--k8s-deployment-api-s3bucket-url=<s> 이 Looker 프로세스가 Kubernetes 보안 비밀로 유지하는 S3 버킷 사용자 인증 정보를 작성할 수 있는 URL입니다.
--log-format=<s> text 또는 json인 로그 형식입니다(기본값: text).
--log-level=<s> 로그 수준입니다(기본값: info).
--log-to-file 로그 출력을 Looker 로그 파일로 보냅니다(기본값: true).
--lookml-runtime-cache-size=<i> LookML 런타임 캐시의 크기(MB)입니다(기본값: 200).
--loose-cipher-key-file 암호화 키 파일의 0600 권한이 필요하지 않습니다(기존 암호화만 해당, 기본값: false).
--marketplace=<s> Looker Marketplace 인스턴스에서 실행 중입니다.
--max-async-threads=<i> 최대 비동기 쿼리 스레드 수입니다(기본값: 200).
--max-configurable-db-connections=<i> UI에서 고객 DB 연결에 허용되는 최대 연결 수입니다.
--max-db-connections-records=<i> db_connection 테이블에서 허용되는 최대 연결 레코드 수입니다(기본값: 10000).
--max-pdt-regen-threads=<i> 최대 PDT 재생성 스레드 수입니다.
--max-scheduled-plans=<i> 최대 활성 반복 예약 계획 수입니다(기본값: unlimited).
--max-scheduler-jitter-in-seconds=<i> 스미어(smear) 처리 플래그 일정이 지정된 시간(초) 동안 무작위로 실행됩니다.
--max-unstreamed-limit=<i> 스트리밍되지 않은 모든 쿼리에 반환될 수 있는 최대 행 수를 설정합니다(기본값: 100,000).
--min-pdt-regen-threads=<i> PDT 재생성의 최소 스레드 수입니다.
--monitoring-port=<i> 모니터링을 호스트(Prometheus, ...)하기 위한 포트입니다(기본값: 1552).
-n, --node-to-node-port=<i> 노드 간 통신용 포트입니다(기본값: 1551).
--new-cipher-key-file=<s> 새 암호화 키가 포함된 파일의 경로입니다(기존 암호화만 해당).
--on-disk-cache-size=<i> 디스크 캐시의 크기(MB)입니다(기본값: 2,000).
-p, --port=<i> 실행할 포트입니다(기본값: 9999).
--per-user-query-limit=<i> 사용자당 동시 쿼리 수를 제한합니다(기본값: 15).
--per-user-query-timeout=<i> 연결을 기다리는 사용자별 제한 시간입니다(기본값: 600).
--prefer-ipv4 IPv4를 우선 사용합니다.
--public-embed-auth-param-file=<s> 공개 인증을 위한 인증 매개변수 파일입니다.
--public-host-url=<s> public_host_url 라이선스 기능이 사용 설정된 경우 이 옵션을 사용하면 관리자가 Looker 작업 API 콜백 URI의 경우 Looker의 기본 호스트 URL이 아닌 public_host_url로 구성되도록 public_host_url 호스트 이름을 지정할 수 있습니다. 시작 옵션 입력은 URL에 후행 슬래시가 없는 https://<my.host.name>여야 합니다. 이 방법을 사용하는 경우 Looker 관리자는 작업 허브를 통해 데이터 공유 문서 페이지에 나열된 고정 이그레스 IP 주소도 허용 목록에 추가해야 합니다.
-q, --queue-broker-port=<i> 큐 브로커의 포트입니다(기본값: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> long 폴 API에서 결과를 사용할 수 있는지 확인하기 전의 최대 절전 모드 간격입니다(기본값: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> long 폴 API가 결과를 사용할 수 있는지 확인하기 위한 초기 절전 모드 간격입니다(기본값: 0.1).
--qm-long-poll-timeout-in-seconds=<i> long 폴 API가 클라이언트에 반환되기 전 최대 서버 측 제한 시간입니다(기본값: 30).
--query-manager-max-threads=<i> 쿼리 관리자의 최대 스레드 수입니다.
--query-manager-min-threads=<i> 쿼리 관리자의 최소 스레드 수입니다.
--query-metrics-retention-hours=<i> 내부 데이터베이스에 query_metrics 데이터를 보관하는 시간입니다(기본값: 336).
--queue-startup-timeout-in-seconds=<i> 시작 시 큐에 연결할 수 있는 시간(초)입니다(기본값: 180).
--query-task-cleanup-interval-seconds=<i> 쿼리 태스크 테이블 정리 작업 사이의 간격입니다(기본값: 600).
--query-task-persistence-duration-minutes=<i> 쿼리 태스크 테이블의 행을 유지하기 위해 쿼리 완료 후 경과된 시간입니다(기본값: 360).
-r, --root 루트로 실행할 수 있습니다.

Looker는 정상 작동을 위한 루트 권한이 필요하지 않습니다. 보안을 위해 루트가 아닌 계정에서 Looker를 실행하는 것이 좋습니다. 예를 들어 문제 해결을 위해 Looker 분석가가 요청하는 경우에만 이 옵션을 루트로 실행합니다.
--redis-cache-config-file=<s> redis 구성이 포함된 파일입니다.
--report-backend-errors, --no-report-backend-errors 백엔드에서 오류를 보고합니다(기본값: false).
--report-frontend-errors, --no-report-frontend-errors 프런트엔드에서 오류를 보고합니다(기본값: false). 참고: 이 시작 옵션은 더 이상 사용되지 않습니다. 대신 client_monitor 기능 플래그를 사용하세요.
-S, --ssh-tunnel-sidecar-url=<s> SSH 터널 서버 사이드카에 연결하는 데 사용되는 기준 URL입니다.
--scheduled-job-attempt-limit=<i> 예약된 작업의 최대 시도 횟수입니다(기본값: 10).
--scheduled-job-max-age-days=<i> 예약된 작업의 최대 삭제 기간입니다(기본값: 60).
--scheduler-query-limit=<i> 동시에 예약된 쿼리 수를 제한합니다(기본값: 10).
--scheduler-query-timeout=<i> 연결 대기를 위한 스케줄러 제한 시간입니다(기본값: 1200).
--scheduler-start-delay=<i> 태스크 실행기 시작을 지연하는 시간(초)입니다(기본값: 60).
--scheduler-threads=<i> 동시에 예약된 태스크 수입니다(기본값: 10).
--search-result-comparison 검색 서비스 결과와 기존 결과를 비교합니다(기본값: false).
--search-service 검색 서비스를 사용 설정합니다(기본값: false).
--search-service-ab-test 검색 서비스의 AB 테스트를 사용 설정합니다(기본값: false).
--self-signup 누구나 직접 계정을 만들 수 있도록 허용합니다.
--shared-storage-dir=<s> 네트워크 파일 시스템 공유 저장소의 경로입니다.
--snowplow-host=<s> 추가 Snowplow 수집기입니다.
--solr-basic-auth=<s> Solr 호출의 기본 사용자 인증 정보입니다(기본값: solr:SolrRocks).
--ssl SSL을 사용합니다(기본값: true).
--ssl-ca-cert=<s> 지원 중단되었습니다. 대신 --ssl-keystore를 사용하세요.
--ssl-cert=<s> 지원 중단되었습니다. 대신 --ssl-keystore를 사용하세요.
--ssl-key=<s> 지원 중단되었습니다. 대신 --ssl-keystore를 사용하세요.
--ssl-keystore-pass-file=<s> ssl-keystore 비밀번호가 포함된 파일의 경로입니다.
--ssl-keystore-pass=<s> ssl-keystore 파일의 비밀번호입니다.
--ssl-keystore=<s> SSL의 키 저장소 파일의 경로입니다.
--ssl-provided-externally-by=<s> Looker를 실행하는 서버에서 액세스할 수 있는 외부 SSL 제공업체의 호스트:포트를 제공합니다. 지정되지 않은 경우 Looker 앱 서버가 SSL을 제공합니다.

다음은 Looker 클러스터 앞에 있는 SSL 프록시의 예시입니다.

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

다음은 Looker 인스턴스와 동일한 호스트에 있는 SSL 제공업체의 예시입니다.

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

null 값은 Looker 앱 서버가 SSL을 제공함을 나타냅니다. 공개 인터넷에 대한 액세스가 제한된 서버에서 Looker 인스턴스를 실행하는 경우 Looker 인스턴스의 서버에서 연결할 수 있는 내부 네트워크에 IP 주소를 지정해야 합니다.
--ssl-provided-externally 지원 중단되었습니다. 대신 --ssl-provided-externally-by를 사용하세요.
--staging 서버를 스테이징으로 실행합니다. 이 옵션을 사용하면 스테이징 인스턴스가 예약된 보고서를 보내지 못하게 됩니다. 하지만 스테이징 인스턴스는 예약된 태스크를 계속 실행하고 예약된 태스크에 문제가 발생하면 예약된 계획 소유자에게 오류 이메일을 전송합니다.
--staging-override-email=<s> 스테이징 인스턴스의 이메일은 일반적인 대상 대신 이 주소로 보냅니다.
--stereo-data-search-enabled 스테레오 데이터 검색 기능을 사용 설정합니다(기본값: false).
--studio-load-url=<s> Studio를 iframe에 로드하기 위한 URL입니다.
--studio-one-platform-endpoint=<s> Studio One Platform API의 엔드포인트입니다.
--task-monitor-abandoned-query-in-seconds=<i> 쿼리 작업이 폐기된 것으로 간주되는 태스크의 마지막 액세스 이후 경과된 시간입니다.
--task-monitor-query-startup-interval-in-seconds=<i> 첫 번째 long 폴이 발생할 때까지 쿼리가 실행을 시작할 때 유예 기간으로 사용되는 기간입니다. 폴링을 시작하기 전에 호출자가 더 많은 공간을 확보할 수 있습니다.
--task-monitor-sleep-interval-in-seconds=<i> 작업 추적 스레드 이전의 절전 모드 간격은 작업이 폐기되었는지 여부를 확인할 수 있습니다.
--unlimited-scheduler-threads=<i> 동시에 예약된 무제한 태스크 수입니다(기본값: 3).
--use-custom-jdbc-config 커스텀 JDBC 드라이버 구성을 사용할지 여부입니다(기본값: false).
--user-db-credentials 제한된 사용량입니다. 연결에서 사용자별 사용자 인증 정보를 사용할 수 있습니다(기본값: false).
-v, --version 버전을 인쇄하고 종료합니다.

사용자 인증 정보 파일 형식

애플리케이션 데이터베이스를 MySQL로 변경한 경우 다음 설정을 포함하는 looker-db.yml라는 사용자 인증 정보 파일이 필요합니다.

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

MySQL 데이터베이스에 SSL 연결이 필요하면 looker-db.yml 파일에 다음도 필요합니다.

ssl: true

시작 옵션을 영구적으로 만들기

시작 구성 설정을 영구적으로 만드는 데 선호되는 방법은 Looker 애플리케이션 디렉터리에 lookerstart.cfg라는 파일을 만드는 것입니다. 이 파일은 looker.jar와 함께 제공된 Looker 시작 스크립트가 실행합니다. lookerstart.cfg 파일은 새 버전의 Looker 시작 스크립트를 설치할 때 덮어쓰지 않으므로 JAVAARGS 및 LOOKERARGS에 대한 환경 변수를 설정하는 데 권장되는 위치입니다.

다음은 Looker의 SSL을 사용 중지하고 포트 8080에서 실행되도록 설정하는 lookerstart.cfg의 예시입니다.

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

lookerstart.cfg를 변경한 후 Looker를 다시 시작해야 합니다.

다음 단계

Looker 시작 옵션을 구성한 후에는 적절한 HTTPS를 위한 SSL 인증서 구성을 수행할 수 있습니다.