Opsi startup Looker

Ada sejumlah setelan startup Looker yang secara opsional dapat dikonfigurasi pada instance yang dihosting pelanggan. Jika tidak perlu mengubah opsi ini, Anda dapat memulai Looker tanpa opsi tersebut.

Daftar opsi startup

Tabel berikut memberikan daftar opsi startup saat ini dalam urutan abjad. Anda juga dapat menampilkan daftar opsi startup dengan menjalankan skrip startup Looker dengan opsi --help.

Opsi Deskripsi
--alerts-scheduler-threads=<i> Jumlah pemberitahuan terjadwal serentak (default: 3).
--ami Tidak digunakan lagi. Sebagai gantinya, gunakan --marketplace=aws.
--api-server-max-threads=<i> Jumlah thread maksimum untuk Server API Puma.
--api-server-min-threads=<i> Jumlah thread minimum untuk Server API Puma.
--application-server-max-threads=<i> Jumlah thread maksimum untuk Server Aplikasi Puma.
--application-server-min-threads=<i> Jumlah thread minimum untuk Server Aplikasi Puma.
--apply-db-migrations Menerapkan migrasi DB saat startup. Nonaktifkan hanya jika Anda menerapkan migrasi secara terpisah (default: true).
--async-results-cache-time=<i> Durasi waktu untuk menyimpan hasil asinkron dalam cache (default: 300).
--byoid-studio-load-url=<s> URL untuk memuat BYOID Studio ke dalam iframe.
--cdn-hosts=<s> Nama host yang dipisahkan koma untuk kumpulan CDN (default: static-a.lookercdn.com,static-b.lookercdn.com).
--cipher-key-file=<s> Jalur ke file yang berisi kunci cipher (hanya enkripsi lama).
--cloud-trace-enabled Aktifkan pelacakan menggunakan kredensial default atau kredensial json jika diberikan melalui cloud_trace_json_file (default: false).
--cloud-trace-json-file=<s> File JSON yang berisi kredensial akun layanan untuk mengupload data rekaman aktivitas ke Google Cloud Trace.
--cloud-trace-project-id=<s> ID project Google untuk mengupload data rekaman aktivitas.
--cloud-trace-sample-rate=<f> Frekuensi (0-1) pengambilan sampel rekaman aktivitas (default: 0,0).
--clustered Apakah server ini merupakan bagian dari cluster (default: false).
--concurrent-render-caching-jobs=<i> Jumlah proses caching rendering serentak (default: 3).
--concurrent-render-jobs=<i> Jumlah proses rendering PhantomJS atau Chromium simultan (default: 2).
--core-on-loopback Mengekspos Core API di antarmuka loopback (default: false).
--core-port=<i> Port untuk menjalankan core (default: 19999).
--customer-artifact-maxsize=<i> Ukuran maksimum dalam MB untuk penyimpanan artefak pelanggan.
-d, --internal-db-creds=<s> Jalur ke file YAML dengan kredensial DB.
--daemonize Berjalan sebagai daemon (default: benar).
--default-mailer-domain=<s> Domain pengirim email default.
--default-mailer-fromemail=<s> Alamat email yang digunakan pengirim email default (default: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Nama host pengirim email default (default: smtp.sendgrid.net).
--default-mailer-password=<s> Sandi pengirim email default (sandi di command line tidak direkomendasikan).
--default-mailer-port=<i> Port pengirim email default (default: 587).
--default-mailer-username=<s> Nama pengguna pengirim email default.
--disable-db-log Menonaktifkan logging kueri DB internal (default: false).
--dogstatsd-host-ip=<s> IP host server statsd Datadog.
--dogstatsd-host-port=<i> Port host server Datadog.
-e, --help Menampilkan daftar opsi startup ini.
--enable-blobstore-recryption Aktifkan enkripsi ulang Blobstore persisten pada operasi penggantian kunci (default: false).
--error-emails-to=<s> Email error ke <email address>.
--experimental-features=<s> Daftar fitur eksperimental yang diizinkan dan dipisahkan dengan koma.
--experimental-routes=<s> Daftar rute eksperimental yang diizinkan dan dipisahkan koma yang membuat rute dengan akhiran -next.
--extension-load-url=<s> URL untuk memuat ekstensi ke dalam iframe yang aman.
--external-solr-enabled Aktifkan Solr eksternal (berbeda dengan Solr bawaan — Solr tersemat) (default: false).
--fips Aktifkan enkripsi FIPS-140 (default: false).
--force-cdn Mengaktifkan CDN secara paksa (default: false).
--force-cipher-key Mengabaikan pengamanan untuk setelan kunci cipher (hanya enkripsi lama, default: false).
--force-enable-pendo Mengaktifkan panduan Pendo pada instance merek pribadi atau dalam konteks sematan (default: false).
--force-error-emails Memaksa Looker melaporkan error melalui email (default: false).
--force-gcm-encryption TIDAK DIGUNAKAN LAGI (opsi ini tidak diperlukan lagi).
--force-mismatched-internal-db Mengizinkan penggunaan DB internal Looker yang tidak disinkronkan (default: false).
--force-no-cdn Menonaktifkan CDN secara paksa (default: false).
--git-hooks-use-local-path Gunakan jalur lokal untuk direktori git_hooks, bukan penyimpanan bersama.
--git-performance-logging Mengaktifkan logging performa JGit (default: false).
--google-analytics-tracker-id=<s> ID Pelacakan yang akan digunakan untuk mengirim tayangan halaman ke pelacak Google Analytics tambahan.
-h, --hosted Di-hosting oleh Looker.
-H, --hostname=<s> Nama host untuk komunikasi antar-node.
--hosted-action-hub-disabled Nonaktifkan hub tindakan yang dihosting.
--in-memory-cache-size=<i> Ukuran (dalam MB) cache dalam memori (default: 200).
--integration-proxy-cert=<s> Jalur ke file sertifikat PKI Integration Proxy.
--integration-proxy-key=<s> Jalur ke file kunci PKI Integration Proxy.
--internal-analytics-connection-file=<s> File YAML yang menjelaskan koneksi analisis internal yang menghosting data untuk model system__activity. Opsi ini hanya untuk digunakan dengan database backend replika baca.
--internal-analytics-connection-pool-size=<i> Jumlah koneksi DB serentak yang dapat menjalankan kueri model aktivitas sistem. Opsi ini hanya untuk digunakan dengan database backend replika baca.
--internal-analytics-retention-days=<i> Jumlah hari untuk menyimpan data histori di database internal. Hal ini tidak memengaruhi proses ETL apa pun. Defaultnya adalah 90. Opsi ini hanya untuk digunakan dengan database backend replika baca.
--k8s-deployment-api-s3bucket-url=<s> URL tempat proses Looker ini dapat menulis kredensial bucket S3 untuk dipertahankan sebagai secret Kubernetes.
--log-format=<s> Format log yang berupa text atau json (default: text).
--log-level=<s> Level log (default: info).
--log-to-file Mengirim output log ke file log Looker (default: true).
--lookml-runtime-cache-size=<i> Ukuran (dalam MB) cache runtime LookML (default: 200).
--loose-cipher-key-file Tidak memerlukan izin 0600 untuk file kunci sandi (hanya enkripsi lama, default: false).
--marketplace=<s> Berjalan di instance Looker Marketplace.
--max-async-threads=<i> Jumlah maksimum thread kueri asinkron (default: 200).
--max-configurable-db-connections=<i> Jumlah koneksi maksimum yang diizinkan untuk koneksi DB pelanggan di UI.
--max-db-connections-records=<i> Jumlah maksimum catatan koneksi yang diizinkan dalam tabel db_connection (default: 10000).
--max-pdt-regen-threads=<i> Jumlah maksimum thread regenerator PDT.
--max-scheduled-plans=<i> Jumlah maksimum rencana terjadwal berulang yang aktif (default: unlimited).
--max-scheduler-jitter-in-seconds=<i> Flag untuk menjalankan jadwal smear secara acak selama jumlah detik yang ditentukan.
--max-unstreamed-limit=<i> Menetapkan jumlah maksimum baris yang dapat ditampilkan untuk semua kueri yang tidak di-streaming (default: 100.000).
--min-pdt-regen-threads=<i> Jumlah thread minimum untuk PDT Regenerator.
--monitoring-port=<i> Port untuk hosting pemantauan (Prometheus, ...) (default: 1552).
-n, --node-to-node-port=<i> Port untuk komunikasi node-ke-node (default: 1551).
--new-cipher-key-file=<s> Jalur ke file yang berisi kunci cipher baru (khusus enkripsi lama).
--on-disk-cache-size=<i> Ukuran (dalam MB) cache disk (default: 2000).
-p, --port=<i> Port yang akan dijalankan (default: 9999).
--per-user-query-limit=<i> Membatasi jumlah kueri serentak per pengguna (default: 15).
--per-user-query-timeout=<i> Durasi waktu tunggu per pengguna untuk menunggu koneksi (default: 600).
--prefer-ipv4 Pilih IPv4.
--public-embed-auth-param-file=<s> File parameter autentikasi untuk autentikasi publik.
--public-host-url=<s> Jika fitur lisensi public_host_url diaktifkan, opsi ini memungkinkan admin menentukan nama host public_host_url sehingga URI callback Looker Action API dibuat dengan public_host_url, bukan URL host default di Looker. Input untuk opsi startup harus berupa https://<my.host.name> tanpa garis miring di akhir URL. Jika menggunakan metode ini, admin Looker juga harus memasukkan alamat IP keluar statis yang tercantum di halaman dokumentasi Membagikan data melalui hub tindakan ke dalam daftar yang diizinkan.
-q, --queue-broker-port=<i> Port untuk broker antrean (default: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> Interval tidur maksimum sebelum API polling panjang akan memeriksa apakah hasil tersedia (default: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> Interval tidur awal sebelum long poll API akan memeriksa apakah hasil tersedia (default: 0,1).
--qm-long-poll-timeout-in-seconds=<i> Waktu tunggu sisi server maksimum untuk API long poll sebelum ditampilkan ke klien (default: 30).
--query-manager-max-threads=<i> Jumlah thread maksimum untuk Pengelola Kueri.
--query-manager-min-threads=<i> Jumlah thread minimum untuk Query Manager.
--query-metrics-retention-hours=<i> Jumlah jam untuk menyimpan data query_metrics dalam database internal (default: 336).
--queue-startup-timeout-in-seconds=<i> Berapa lama dalam detik untuk mengizinkan koneksi ke antrean saat startup (default: 180).
--query-task-cleanup-interval-seconds=<i> Interval antara tugas pembersihan tabel tugas kueri (default: 600).
--query-task-persistence-duration-minutes=<i> Jumlah waktu setelah penyelesaian kueri untuk menyimpan baris dalam tabel tugas kueri (default: 360).
-r, --root Memungkinkan berjalan sebagai root.

Looker tidak memerlukan hak istimewa root untuk pengoperasian normal. Untuk tujuan keamanan, sebaiknya jalankan Looker di akun non-root. Gunakan opsi untuk menjalankan sebagai root hanya jika diperlukan, misalnya, jika diminta oleh analis Looker untuk tujuan pemecahan masalah.
--redis-cache-config-file=<s> File yang berisi konfigurasi redis.
--report-backend-errors, --no-report-backend-errors Melaporkan error dari backend (default: false).
--report-frontend-errors, --no-report-frontend-errors Melaporkan error dari frontend (default: false). CATATAN: Opsi peluncuran ini sudah tidak berlaku. Gunakan flag fitur client_monitor sebagai gantinya.
-S, --ssh-tunnel-sidecar-url=<s> URL dasar yang digunakan untuk terhubung ke SSH Tunnel Server Sidecar.
--scheduled-job-attempt-limit=<i> Jumlah maksimum percobaan tugas terjadwal (default: 10).
--scheduled-job-max-age-days=<i> Usia maksimum tugas terjadwal sebelum dihapus (default: 60).
--scheduler-query-limit=<i> Membatasi jumlah kueri terjadwal serentak (default: 10).
--scheduler-query-timeout=<i> Durasi waktu tunggu penjadwal untuk menunggu koneksi (default: 1200).
--scheduler-start-delay=<i> Jumlah detik penundaan sebelum memulai peluncuran task runner (default: 60).
--scheduler-threads=<i> Jumlah tugas terjadwal serentak (default: 10).
--search-result-comparison Bandingkan hasil Search Service dengan hasil lama (default: false).
--search-service Mengaktifkan Search Service (default: false).
--search-service-ab-test Aktifkan pengujian AB untuk Search Service (default: false).
--self-signup Mengizinkan siapa saja membuat akun untuk dirinya sendiri.
--shared-storage-dir=<s> Jalur ke penyimpanan bersama sistem file jaringan.
--snowplow-host=<s> Kolektor Snowplow tambahan.
--solr-basic-auth=<s> Kredensial autentikasi dasar untuk panggilan ke Solr (default: solr:SolrRocks).
--ssl Menggunakan SSL (default: true).
--ssl-ca-cert=<s> Tidak digunakan lagi. Sebagai gantinya, gunakan --ssl-keystore.
--ssl-cert=<s> Tidak digunakan lagi. Sebagai gantinya, gunakan --ssl-keystore.
--ssl-key=<s> Tidak digunakan lagi. Sebagai gantinya, gunakan --ssl-keystore.
--ssl-keystore-pass-file=<s> Jalur ke file yang berisi sandi ssl-keystore.
--ssl-keystore-pass=<s> Sandi untuk file ssl-keystore.
--ssl-keystore=<s> Jalur ke file keystore untuk SSL.
--ssl-provided-externally-by=<s> Menyediakan host:port untuk penyedia SSL eksternal yang dapat diakses dari server yang menjalankan Looker. Jika tidak ditentukan, server aplikasi Looker akan menyediakan SSL.

Berikut adalah contoh untuk proxy SSL di depan cluster Looker:

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

Berikut adalah contoh penyedia SSL di host yang sama dengan instance Looker Anda:

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

Nilai null menunjukkan bahwa server aplikasi Looker menyediakan SSL. Jika instance Looker Anda berjalan di server dengan akses terbatas ke internet publik, Anda harus menentukan alamat IP di jaringan internal yang dapat dijangkau oleh server untuk instance Looker Anda.
--ssl-provided-externally Tidak digunakan lagi. Sebagai gantinya, gunakan --ssl-provided-externally-by.
--staging Menjalankan server sebagai penyiapan. Opsi ini akan mencegah instance penyiapan Anda mengirim laporan terjadwal. Namun, instance penyiapan akan terus menjalankan tugas terjadwal dan akan mengirimkan email error kepada pemilik paket terjadwal jika tugas terjadwal mengalami masalah.
--staging-override-email=<s> Mengirim email di instance penyiapan ke alamat ini, bukan ke tujuan normalnya.
--stereo-data-search-enabled Aktifkan fitur penelusuran data stereo (default: false).
--studio-load-url=<s> URL untuk memuat Studio ke dalam iframe.
--studio-one-platform-endpoint=<s> Endpoint untuk Studio One Platform API.
--task-monitor-abandoned-query-in-seconds=<i> Durasi yang berlalu sejak akses terakhir untuk tugas yang akan dianggap sebagai tugas kueri yang ditinggalkan.
--task-monitor-query-startup-interval-in-seconds=<i> Durasi yang digunakan sebagai masa tenggang saat kueri mulai dieksekusi hingga polling panjang pertama terjadi. Hal ini membantu memberikan lebih banyak ruang bagi penelepon sebelum memulai polling.
--task-monitor-sleep-interval-in-seconds=<i> Interval tidur sebelum thread pelacakan tugas dapat memeriksa apakah tugas ditinggalkan.
--unification-jwt-service-account=<s> Akun layanan Unification JWT.
--unlimited-scheduler-threads=<i> Jumlah tugas terjadwal tanpa batas secara bersamaan (default: 3).
--use-custom-jdbc-config Apakah akan menggunakan konfigurasi driver JDBC kustom (default: false).
--user-db-credentials Penggunaan terbatas. Koneksi dapat menggunakan kredensial per pengguna (default: false).
-v, --version Mencetak versi dan keluar.

Format file kredensial

Jika telah mengubah database aplikasi ke MySQL, Anda memerlukan file kredensial bernama looker-db.yml yang menyertakan setelan berikut:

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

Jika database MySQL Anda memerlukan koneksi SSL, file looker-db.yml juga memerlukan hal berikut:

ssl: true

Membuat opsi startup permanen

Metode yang disarankan untuk membuat setelan konfigurasi startup menjadi permanen adalah dengan membuat file bernama lookerstart.cfg di direktori aplikasi Looker. File ini akan dieksekusi oleh skrip startup Looker yang disediakan bersama looker.jar Anda. File lookerstart.cfg adalah tempat yang direkomendasikan untuk menyetel variabel lingkungan untuk JAVAARGS dan LOOKERARGS karena variabel tersebut tidak akan ditimpa saat skrip startup Looker versi baru diinstal.

Berikut adalah contoh lookerstart.cfg, yang menonaktifkan SSL Looker dan menyetelnya untuk berjalan di port 8080:

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

Looker harus dimulai ulang setelah melakukan perubahan pada lookerstart.cfg.

Langkah berikutnya

Setelah mengonfigurasi opsi startup Looker, Anda siap mengonfigurasi sertifikat SSL untuk HTTPS yang tepat.