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

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

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

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

אפשרות תיאור
--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 החלת העברות של מסדי נתונים בזמן ההפעלה. צריך להשבית את האפשרות הזו רק אם מבצעים העברות בנפרד (ברירת המחדל: 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 בממשק לולאה חזרה (ברירת המחדל: 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 השבתת הרישום ביומן של שאילתות DB פנימיות (ברירת המחדל: 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 משביתים את מרכז הפעולות המתארח.
--in-memory-cache-size=<i> גודל (במגה-בייט) של מטמון הזיכרון (ברירת המחדל: 200).
--integration-proxy-cert=<s> הנתיב לקובץ האישור של Integration Proxy PKI.
--integration-proxy-key=<s> הנתיב לקובץ המפתח של Integration Proxy PKI.
--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 בחיבור. שימו לב שההגדרה Max concurrent queries per user for this connection היא לכל משתמש ולכל חיבור, אבל לא לכל צומת. מידע נוסף זמין בדף התיעוד קישור 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 של הסקר הארוך יבדוק אם יש תוצאות זמינות (ברירת המחדל: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> מרווח השינה הראשוני לפני שה-API של הסקר הארוך יבדוק אם התוצאות זמינות (ברירת המחדל: 0.1).
--qm-long-poll-timeout-in-seconds=<i> זמן קצוב מקסימלי לתפוגה בצד השרת של ה-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 בסביבת הייצור עם פלייסהולדר של אזור לטעינת BYOID Studio ב-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 דיווח על שגיאות מה-frontend (ברירת המחדל: false). הערה: אפשרות ההפעלה הזו מיושנת. במקום זאת, צריך להשתמש ב-feature flag‏ 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 הפעלת בדיקת 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> מציין את המארח:יציאה של ספק 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> חשבון שירות Unification 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. הקובץ lookerstart.cfg הוא המקום המומלץ להגדרת משתני סביבה ל-JAVAARGS ול-LOOKERARGS, כי הם לא יוחלפו כשגרסאות חדשות של סקריפט לטעינה בזמן ההפעלה של Looker יותקנו.

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

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

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

השלבים הבאים

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