טלמטריה ב-Cortex Framework
במהלך תהליכי הפריסה והסנכרון, Cortex Framework אוסף נתוני שימוש אנונימיים.
מטרת איסוף הנתונים
- הערכת השימוש בתכונות: מעקב אחרי התדירות של פריסות מודולים של מסגרות ומוצרי נתונים עוזר לקבוע את סדרי העדיפויות בפיתוח.
- זיהוי דפוסי שילוב: מעקב אחרי וריאציות של מערכות מקור מקושרות (לדוגמה, SAP ECC, SAP S/4HANA) מאפשר לאמת את התאימות ולתת עדיפות לתחזוקה של השילובים האלה.
הטלמטריה מופעלת כברירת מחדל. כדי להשבית את התכונה, אפשר לעיין בקטע 'השבתת טלמטריה'.
נתונים שנאספו
המסגרת אוספת מזהי הגדרות, כמו מזהי קבוצות נתונים, מזהי מופעים של מוצרי נתונים ומזהי מאגרים. לא נאספים מאפייני זהות של משתמשים, כמו שמות, כתובות אימייל או כתובות IP.
- מספר הפרויקט בענן של Google Cloud: מזהה את הפרויקט שבו פועל הפריסה, ומועבר בכותרת
X-Goog-User-Projectלצורך צבירת נתוני השימוש. - אזור או מיקום הפריסה: האזור שבו נפרסים משאבי היעד. משמש למעקב אחר ההתפלגות הגיאוגרפית.
- גרסת המסגרת: הגרסה של בסיס הקוד של Cortex Framework שנמצא בשימוש (לדוגמה,
7.0.0). - שם הרכיב: רכיב הארכיטקטורה ברמה הגבוהה שעליו מתבצעת הפעולה (לדוגמה,
platform,data-productאוfoundation). - סוג הכלי: הפקודה או כלי השירות הספציפיים של ה-CLI שהופעלו (לדוגמה,
deployerאוknowledge-catalog) - Target variant (גרסת יעד): קטגוריית מערכת המקור או הדומיין של המודולים שנפרסו (למשל,
sapאוmarketing). - סוגי מודולים שהופעלו: שמות הספריות או הנתיבים של מודולים ספציפיים שהופעלו בהגדרה.
- מזהה מאגר Dataform: השם שהמשתמש הגדיר למאגר היעד של Dataform.
- מזהה מערך הנתונים ב-BigQuery: השם של מערך הנתונים ב-BigQuery שהמשתמש הגדיר כיעד.
- מזהה של מופע של מוצר נתונים: המזהה שסופק על ידי המשתמש ומשמש במהלך שלב הרישום של Knowledge Catalog לזיהוי מוצרי נתונים רשומים.
- סטטוס הביצוע: מצב ההצלחה או הכשל של שלב הפריסה (לדוגמה,
deployed,post-deploy-success,error,registeredאוupdated).
מבנה הכותרת של סוכן המשתמש
פרמטרים של טלמטריה מוזרקים לבקשות Google Cloud API באמצעות כותרת HTTP מיוחדת של סוכן משתמש, שמעוצבת באופן דינמי לפי התבנית הבאה:
gcp-cortex-eng/framework/<version>/<component>/<tool_type>/<variant>[/<optional_extension>]/<status>
לדוגמה, כשמבצעים פריסה מוצלחת של SAP ERP foundations:
gcp-cortex-eng/framework/7.0.0/platform/deployer/sap/cortex/sap/foundations/sap/deployed
העברת נתונים
Cortex Framework משתמש במנגנון פסיבי לרישום מטא-נתונים ללא מטען ייעודי (payload). במקום לשדר מטען ייעודי של יומנים לנקודות קצה חיצוניות, אירועי טלמטריה מתועדים באמצעות אינטראקציות רגילות עם שירותים Google Cloud .
במהלך ההפעלה של פקודות הפריסה, הסנכרון או ההדגמה, המסגרת מתקשרת עם ממשקי API סטנדרטיים של Google Cloud , כולל BigQuery ו-Dataform.
לא נשלחים נתוני טלמטריה בגוף של בקשות ה-API האלה. במקום זאת, נתוני הטלמטריה נאספים באופן מקורי על ידי רישום תנועת ה-API של Google Cloud, שמנתח את הכותרות המותאמות אישית של סוכן המשתמש ומספר הפרויקט כדי למדוד את שיעורי האימוץ וההצלחה של הפתרון.
השבתת הטלמטריה
המסגרת של Cortex מכבדת את הגדרות הפרטיות שלכם ומיישמת מדיניות של ביטול הסכמה קבוע. אפשר לנהל את הטלמטריה באופן גלובלי באמצעות הכלי cortex-config או על ידי העברת דגל CLI במהלך ההפעלה.
השבתה בכל העולם
אפשר לנהל את הטלמטריה על ידי עדכון קובץ העדפות משתמש קבוע שנמצא במחשב בנתיב ~/.cortex/cortex-framework-consent.properties. אם הקובץ הזה מכיל את הערך enable_telemetry=false, הקריאות ל-API של הטלמטריה מדלגות לחלוטין בזמן הריצה.
- ביטול ההסכמה לצמיתות (השבתה גלובלית):
uv run cortex-config telemetry disable
- הצטרפות לצמיתות (הפעלה גלובלית):
uv run cortex-config telemetry enable
- בדיקת הסטטוס הנוכחי:
uv run cortex-config telemetry status
השבתה להרצה יחידה
אפשר להעביר את הדגל --disable-telemetry לפקודות ההפעלה. כשמריצים את הפקודה --disable-telemetry פעם אחת, ה-framework יוצר באופן אוטומטי את קובץ התצורה הקבוע בנתיב ~/.cortex/cortex-framework-consent.properties, שמכיל את הערך enable_telemetry=false.
## Cortex Framework-deploy
uv run cortex-deploy --config config/config.yaml --disable-telemetry
## Cortex Framework-build-and-deploy
uv run cortex-build-and-deploy --config config/config.yaml --disable-telemetry
## Cortex Framework-demo
uv run cortex-demo --config config/config.yaml --disable-telemetry
## Cortex Framework-kc-sync
uv run cortex-kc-sync --config config/config.yaml --disable-telemetry
מידע נוסף על הפקודות האלה והפרמטרים שלהן זמין במאמרי העזרה הבאים בנושא CLI: