אפשרויות הפעלה של Looker

יש כמה הגדרות הפעלה של Looker שאפשר להגדיר במופעים באירוח בצד הלקוח. אם אתם לא צריכים לשנות את האפשרויות האלה, אתם יכולים להפעיל את Looker בלעדיהן.

רשימת אפשרויות ההפעלה

בטבלה הבאה מפורטות אפשרויות ההפעלה הנוכחיות בסדר אלפביתי. אפשר גם להציג רשימה של אפשרויות הפעלה על ידי הרצת סקריפט לטעינה בזמן ההפעלה של Looker עם האפשרות --help.

אפשרות תיאור
--alerts-scheduler-threads=<i> מספר ההתראות המתוזמנות בו-זמנית (ברירת מחדל: 3).
--ami הוצאה משימוש, במקום זאת, אתם צריכים להשתמש ב---marketplace=aws.
--api-server-max-threads=<i> מספר ה-Threads המקסימלי לשרת Puma API.
--api-server-min-threads=<i> מספר השרשורים המינימלי לשרת Puma API.
--application-server-max-threads=<i> מספר השרשורים המקסימלי לשרת האפליקציות Puma.
--application-server-min-threads=<i> מספר ה-threads המינימלי לשרת האפליקציות של Puma.
--apply-db-migrations החלת העברות של מסד נתונים בזמן ההפעלה. צריך להשבית את האפשרות הזו רק אם מבצעים העברות בנפרד (ברירת המחדל: true).
--async-results-cache-time=<i> משך הזמן לשמירת תוצאות אסינכרוניות במטמון (ברירת המחדל: 300).
--byoid-studio-load-url=<s> כתובת ה-URL לטעינת BYOID Studio ב-iframe.
--cdn-hosts=<s> שמות מארחים מופרדים בפסיקים למאגר CDN (ברירת מחדל: static-a.lookercdn.com,static-b.lookercdn.com).
--cipher-key-file=<s> הנתיב לקובץ שמכיל את מפתח ההצפנה (הצפנה מדור קודם בלבד).
--cloud-trace-enabled הפעלת מעקב באמצעות פרטי כניסה שמוגדרים כברירת מחדל או פרטי כניסה בפורמט JSON אם הם סופקו באמצעות --cloud-trace-json-file (ברירת מחדל: false).
--cloud-trace-json-file=<s> קובץ JSON שמכיל את פרטי הכניסה לחשבון השירות כדי להעלות נתוני מעקב אל Google Cloud Trace.
--cloud-trace-project-id=<s> מזהה הפרויקט ב-Google שאליו רוצים להעלות את נתוני המעקב.
--cloud-trace-sample-rate=<f> השיעור (0-1) שבו נדגמים המעקבים (ברירת המחדל: 0.0).
--clustered אם השרת הזה הוא חלק מאשכול (ברירת המחדל: false).
--concurrent-render-caching-jobs=<i> מספר התהליכים של שמירת עיבודים במטמון שמתבצעים בו-זמנית (ברירת המחדל: 3).
--concurrent-render-jobs=<i> מספר תהליכי העיבוד (rendering) של PhantomJS או Chromium שמתבצעים בו-זמנית (ברירת המחדל: 2).
--core-on-loopback חשיפת Core API בממשק loopback (ברירת מחדל: false).
--core-port=<i> היציאה שבה הליבה תפעל (ברירת המחדל: 19999).
--customer-artifact-maxsize=<i> הגודל המקסימלי ב-MB של מאגר פריטי המידע שנוצרו בעקבות פעילות הלקוח.
-d, --internal-db-creds=<s> הנתיב לקובץ YAML עם פרטי הכניסה למסד הנתונים.
--daemonize פועל כדימון (ברירת מחדל: true).
--db-migrations-kill-timeout=<i> הזמן הקצוב לתפוגה של העברת מסדי נתונים בשניות (ברירת המחדל: 480).
--db-migrations-lock-wait-timeout=<i> זמן קצוב לתפוגה של נעילה להעברות של מסדי נתונים בשניות (ברירת מחדל: 180).
--db-migrations-monitor-cutoff=<i> מועד אחרון למעקב אחרי העברות של מסדי נתונים פנימיים בשניות (ברירת המחדל: 2592000).
--db-migrations-wait-timeout=<i> זמן קצוב לתפוגה של המתנה להעברות של מסדי נתונים בשניות (ברירת המחדל: 720).
--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 משבית את הרישום ביומן של שאילתות פנימיות במסד הנתונים (ברירת מחדל: false).
--dogstatsd-host-ip=<s> כתובת ה-IP של המארח של שרת Datadog statsd.
--dogstatsd-host-port=<i> יציאת מארח השרת של Datadog.
-e, --help מציגה את הרשימה הזו של אפשרויות ההפעלה.
--enable-blobstore-recryption הפעלה של הצפנה מחדש של Persistent Blobstore בפעולות של החלפת מפתחות (ברירת המחדל: false).
--error-emails-to=<s> אימיילים על שגיאות אל <email address>.
--experimental-features=<s> רשימה מופרדת בפסיקים של תכונות ניסיוניות מותרות.
--experimental-routes=<s> רשימה מופרדת בפסיקים של מסלולים ניסיוניים מותרים שיוצרים מסלולים עם הסיומת ‎-next.
--extension-load-url=<s> כתובת URL לטעינת תוספים ל-iframe מאובטח.
--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 שלא מסונכרן (ברירת מחדל: false).
--force-no-cdn השבתה כפויה של CDN (ברירת המחדל: false).
--git-hooks-use-local-path צריך להשתמש בנתיב מקומי לספרייה git_hooks במקום בנפח אחסון משותף.
--git-performance-logging הפעלת רישום ביומן של ביצועי JGit (ברירת המחדל: false).
--google-analytics-tracker-id=<s> מזהה לצורכי מעקב שמשמש לשליחת צפיות בדפים למעקבים נוספים של Google Analytics.
-h, --hosted באירוח של Looker.
-H, --hostname=<s> שם המארח לתקשורת בין צמתים.
--hosted-action-hub-disabled השבתת מרכז הפעולות באירוח Google.
--in-memory-cache-size=<i> גודל (במגה-בייט) של מטמון הזיכרון (ברירת המחדל: 200).
--integration-proxy-cert=<s> הנתיב לקובץ האישור של PKI של שרת ה-Proxy של השילוב.
--integration-proxy-key=<s> הנתיב לקובץ המפתח של ה-PKI של Integration Proxy.
--internal-analytics-connection-file=<s> קובץ YAML שמתאר את החיבור לניתוח הנתונים הפנימי שמארח נתונים למודל system__activity. האפשרות הזו מיועדת לשימוש רק עם מסד נתונים לקריאה בלבד של רפליקה בקצה העורפי.
--internal-analytics-connection-pool-size=<i> מספר החיבורים בו-זמנית למסד הנתונים שיכולים להריץ שאילתות של מודל פעילות המערכת. האפשרות הזו מיועדת לשימוש רק עם מסד נתונים לקריאה בלבד של רפליקה בקצה העורפי.
--internal-data-apps-on-gcs מאפשר לתוספי אפליקציות של נתונים לאחזר נכסים בזמן ריצה מ-Google Cloud Storage (פנימי/ל-Googlers בלבד).
--internal-analytics-retention-days=<i> מספר הימים לשמירת נתוני ההיסטוריה במסד הנתונים הפנימי. השינוי הזה לא משפיע על אף תהליך ETL. ערך ברירת המחדל הוא 90. האפשרות הזו מיועדת לשימוש רק עם מסד נתונים לקריאה בלבד של רפליקה בקצה העורפי.
--k8s-deployment-api-s3bucket-url=<s> כתובת ה-URL שבה תהליך Looker הזה יכול לכתוב פרטי כניסה של קטגוריית S3 כדי לשמור אותם כסודות של Kubernetes.
--load-chronicle-dialect האם לטעון את הניב המובנה של Chronicle (ברירת מחדל: false).
--log-format=<s> פורמט היומן, שיכול להיות text או json (ברירת המחדל: text).
--log-frontend-errors רישום פרטי השגיאה מה-frontend לקובץ היומן של הלקוח (ברירת המחדל: false).
--log-level=<s> רמת היומן (ברירת מחדל: info).
--log-to-file שליחת פלט של יומן לקובץ יומן של Looker (ברירת המחדל: true).
--lookerdb-query-timeout=<i> ערך הזמן הקצוב לתפוגה של שאילתות במסד הנתונים הפנימי של Looker, באלפיות השנייה (ברירת המחדל: 0).
--lookml-runtime-cache-size=<i> גודל (ב-MB) של מטמון זמן הריצה של LookML (ברירת מחדל: 200).
--loose-cipher-key-file לא לדרוש הרשאות 0600 לקובץ מפתח ההצפנה (הצפנה מדור קודם בלבד, ברירת המחדל: false).
--marketplace=<s> פועל במכונה של Looker Marketplace.
--max-async-threads=<i> המספר המקסימלי של שרשורי שאילתות אסינכרוניות (ברירת המחדל: 200).
--max-configurable-db-connections=<i> המספר המקסימלי של חיבורים שמותרים לחיבור מסד נתונים של לקוח בממשק המשתמש.
--max-db-connections-records=<i> מספר רשומות החיבור המקסימלי שמותר בטבלה db_connection (ברירת המחדל: 10,000).
--max-pdt-regen-threads=<i> המספר המקסימלי של שרשורי מחולל PDT.
--max-scheduled-plans=<i> מספר מקסימלי של תוכניות פעילות שנקבעו מראש וחוזרות על עצמן (ברירת המחדל: unlimited).
--max-scheduler-jitter-in-seconds=<i> דגל להפעלת תזמון אקראי של הפעלות על פני מספר השניות הנתון.
--max-unstreamed-limit=<i> מגדיר את המספר המקסימלי של שורות שאפשר להחזיר לכל השאילתות שלא מועברות בסטרימינג (ברירת המחדל: 100,000).
--min-pdt-regen-threads=<i> מספר השרשורים המינימלי ל-PDT Regenerator.
--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> מגבילה את מספר השאילתות בו-זמנית לכל משתמש, לכל חיבור ולכל צומת במכונה של Looker (ברירת המחדל: 15). אם מספקים ערך להגדרה Max concurrent queries per user for this connection, הערך הזה מבטל את per-user-query-limit בחיבור. שימו לב שההגדרה מספר מקסימלי של שאילתות מקבילות לכל משתמש עבור החיבור הזה היא לכל משתמש ולכל חיבור, אבל לא לכל צומת. מידע נוסף זמין בדף חיבור Looker למסד הנתונים.
--per-user-query-timeout=<i> משך הזמן הקצוב לתפוגה לכל משתמש בהמתנה לחיבור (ברירת המחדל: 600).
--prefer-ipv4 עדיף להשתמש ב-IPv4.
--public-embed-auth-param-file=<s> קובץ פרמטרים לאימות עבור אימות ציבורי.
--public-host-url=<s> אם התכונה של רישיון public_host_url מופעלת, האפשרות הזו מאפשרת לאדמינים לציין שם מארח של public_host_url כדי שכתובות ה-URI להחזרת קריאה (callback) של Looker Action API ייווצרו עם public_host_url ולא עם כתובת ה-URL של המארח שמוגדרת כברירת מחדל ב-Looker. הקלט לאפשרות ההפעלה צריך להיות https:// בלי קו נטוי בסוף כתובת ה-URL. אם משתמשים בשיטה הזו, האדמינים ב-Looker צריכים גם להוסיף לרשימת ההיתרים את כתובות ה-IP הסטטיות של תעבורת הנתונים היוצאת שמפורטות בדף התיעוד שיתוף נתונים דרך מרכז פעולות.
-q, --queue-broker-port=<i> יציאה ל-queue broker (ברירת מחדל: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> מרווח השינה המקסימלי לפני ש-API של long poll יבדוק אם יש תוצאות זמינות (ברירת מחדל: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> מרווח השינה הראשוני לפני שה-API של הסקר הארוך יבדוק אם יש תוצאות זמינות (ברירת המחדל: 0.1).
--qm-long-poll-timeout-in-seconds=<i> זמן קצוב לתפוגה מקסימלי בצד השרת עבור Long Poll 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 מאפשרת הפעלה כמשתמש root.

כדי ש-Looker תפעל כרגיל, לא נדרשות הרשאות ברמת הבסיס (root). מטעמי אבטחה, מומלץ להפעיל את Looker בחשבון שאינו חשבון בסיס. השתמשו באפשרות להפעיל כמשתמש root רק כשצריך, למשל אם מנתח נתונים של Looker ביקש זאת למטרות פתרון בעיות.
--redis-cache-config-file=<s> קובץ שמכיל את הגדרות Redis.
--regionalised-prod-byoid-studio-load-url=<s> כתובת URL של Prod עם פלייס הולדר של אזור לטעינת סטודיו BYOID ב-iframe.
--regionalised-prod-studio-load-url=<s> כתובת URL של סביבת הייצור עם פלייס הולדר לאזור לטעינת Studio.
--regionalised-prod-studio-one-platform-endpoint=<s> נקודת קצה (endpoint) בסביבת ייצור עם פלייסהולדר לאזור ל-Studio One Platform API.
--report-backend-errors, --no-report-backend-errors דיווח על שגיאות מה-backend (ברירת המחדל: false).
--report-frontend-errors, --no-report-frontend-errors דיווח על שגיאות מהחלק הקדמי (ברירת מחדל: false). הערה: אפשרות ההפעלה הזו יצאה משימוש. במקום זאת, צריך להשתמש בדגל התכונה client_monitor.
-S, --ssh-tunnel-sidecar-url=<s> כתובת ה-URL הבסיסית שמשמשת להתחברות ל-SSH Tunnel Server Sidecar.
--scheduled-job-attempt-limit=<i> מספר הניסיונות המקסימלי של משימות מתוזמנות (ברירת המחדל: 10).
--scheduled-job-max-age-days=<i> הגיל המקסימלי של משימה מתוזמנת לפני שהיא נמחקת (ברירת מחדל: 60).
--scheduler-query-limit=<i> מגביל את מספר השאילתות המתוזמנות שמופעלות בו-זמנית (ברירת מחדל: 10).
--scheduler-query-timeout=<i> משך הזמן הקצוב לתפוגה של המתזמן להמתנה לחיבור (ברירת המחדל: 1,200).
--scheduler-start-delay=<i> מספר השניות להשהיה לפני הפעלת מנהל המשימות (ברירת המחדל: 60).
--scheduler-threads=<i> מספר המשימות המתוזמנות שניתן להריץ בו-זמנית (ברירת מחדל: 10).
--search-result-comparison השוואה בין התוצאות של שירות החיפוש לבין התוצאות הקודמות (ברירת המחדל: false).
--search-service הפעלת שירות החיפוש (ברירת מחדל: false).
--search-service-ab-test מפעילים בדיקת A/B עבור שירות החיפוש (ברירת מחדל: 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> מציין את המארח:יציאה של ספק SSL חיצוני, כפי שניתן לגשת אליו מהשרת שבו פועל Looker. אם לא מציינים, שרת האפליקציות של Looker מספק SSL.

דוגמה לשרת proxy מסוג SSL לפני אשכול Looker:

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

דוגמה לספק SSL באותו מארח כמו המכונה של Looker:

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

ערך null מציין ששרת האפליקציה של Looker מספק SSL. אם מכונת Looker שלכם פועלת בשרת עם גישה מוגבלת לאינטרנט הציבורי, תצטרכו לציין כתובת IP ברשת הפנימית שלכם שהשרת יכול להגיע אליה עבור מכונת Looker.
--ssl-provided-externally הוצאה משימוש, במקום זאת, אתם צריכים להשתמש ב---ssl-provided-externally-by.
--staging הפעלת השרת כסביבת Staging. האפשרות הזו תמנע מהמופע של סביבת ה-Staging לשלוח דוחות מתוזמנים. עם זאת, המכונה הזמנית תמשיך להריץ משימות מתוזמנות ותשלח הודעות אימייל על שגיאות לבעלים של התוכניות המתוזמנות אם יהיו בעיות במשימה המתוזמנת.
--staging-override-email=<s> שליחת אימיילים במופע של Staging לכתובת הזו במקום ליעד הרגיל שלהם.
--stereo-data-search-enabled הפעלת התכונה של חיפוש נתונים בסטריאו (ברירת המחדל: false).
--studio-load-url=<s> כתובת ה-URL לטעינת Studio ב-iframe.
--studio-one-platform-endpoint=<s> נקודת קצה ל-Studio One Platform API.
--task-monitor-abandoned-query-in-seconds=<i> משך הזמן שחלף מאז הגישה האחרונה למשימה, שקובע מתי המשימה נחשבת לנטושה.
--task-monitor-query-startup-interval-in-seconds=<i> משך הזמן שמשמש כתקופת חסד מרגע שהשאילתות מתחילות לפעול ועד שמתרחשת דגימה ארוכה ראשונה. כך יש יותר מקום למשתתפים לפני שמתחילים את הסקר.
--task-monitor-sleep-interval-in-seconds=<i> מרווח הזמן בין בדיקות השינה לפני שהשרשור של מעקב המשימות יכול לבדוק אם משימות ננטשו.
--unification-jwt-service-account=<s> חשבון שירות של JWT לאיחוד.
--unlimited-scheduler-threads=<i> מספר המשימות המתוזמנות ללא הגבלה בו-זמנית (ברירת המחדל: 3).
--url-flags-override מאפשר לבטל את ההגדרה של feature flag באמצעות פרמטרים של שאילתה בכתובת URL.
--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

הפיכת אפשרויות ההפעלה לקבועות

השיטה המועדפת להגדרת תצורת ההפעלה באופן קבוע היא ליצור קובץ בשם lookerstart.cfg בספריית האפליקציה של Looker. הקובץ הזה יופעל על ידי סקריפט לטעינה בזמן ההפעלה של Looker שסופק עם looker.jar. מומלץ להגדיר משתני סביבה ל-JAVAARGS ול-LOOKERARGS בקובץ lookerstart.cfg, כי הם לא יוחלפו כשמתקינים גרסאות חדשות של סקריפט לטעינה בזמן ההפעלה של Looker.

הנה דוגמה לקובץ lookerstart.cfg שמשבית את ה-SSL של Looker ומגדיר אותו לפעול ביציאה 8080:

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

אחרי שמבצעים שינויים ב-lookerstart.cfg, צריך להפעיל מחדש את Looker.

השלבים הבאים

אחרי שמגדירים את אפשרויות ההפעלה של Looker, אפשר להגדיר את אישור ה-SSL כדי להשתמש ב-HTTPS.