אפשרויות הפעלה של 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> מספר ה-Threads המקסימלי לשרת האפליקציות של Puma.
--application-server-min-threads=<i> מספר השרשורים המינימלי לשרת האפליקציות של 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> מספר תהליכי הרינדור של 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> המועד האחרון למעקב אחרי העברות פנימיות של מסדי נתונים בשניות (ברירת מחדל: 2,592,000).
--db-migrations-wait-timeout=<i> זמן ההמתנה (timeout) להעברות של מסדי נתונים בשניות (ברירת מחדל: 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 הפעלה של הצפנה מחדש קבועה של 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 השבתת מרכז הפעולות באירוח.
--in-memory-cache-size=<i> גודל (ב-MB) של מטמון בזיכרון (ברירת מחדל: 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-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 פרטי שגיאה ביומן מהקצה הקדמי נרשמים בקובץ היומן של הלקוח (ברירת מחדל: 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 regenerator.
--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). אם מספקים ערך להגדרה מספר מקסימלי של שאילתות מקבילות לכל משתמש בחיבור הזה, הערך הזה יבטל את הערך 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 של Long Poll יבדוק אם יש תוצאות זמינות (ברירת מחדל: 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.

לא נדרשות הרשאות root כדי להפעיל את Looker בצורה רגילה. מטעמי אבטחה, מומלץ להפעיל את Looker בחשבון שאינו חשבון root. מומלץ להשתמש באפשרות להפעלה כמשתמש 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> נקודת קצה של סביבת הייצור עם placeholder של אזור עבור Studio One Platform API.
--report-backend-errors, --no-report-backend-errors דיווח על שגיאות מהקצה העורפי (ברירת מחדל: 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> משך הזמן הקצוב לתפוגה של מתזמן ההמתנה לחיבור (ברירת מחדל: 1200).
--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-override-email=<s> שולח אימיילים במופע של סביבת פיתוח לכתובת הזו במקום ליעד הרגיל שלהם.
--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 מאפשר לבטל את ההגדרה של דגלי תכונות באמצעות פרמטר שאילתה בכתובת 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 בצורה תקינה.