במאמר הזה מוסבר למה מומלץ לשלוח את נתוני העקבות אל פרויקטGoogle Cloud באמצעות Telemetry API (OTLP), שמטמיע את פרוטוקול OpenTelemetry OTLP. הוא גם מספק הנחיות לגבי הטמעה של כלי מעקב באפליקציות שלכם, ומציין איפה אפשר לראות את נתוני המעקב. אתם יכולים להשתמש ב-Telemetry API כשאתם מבצעים אינסטרומנטציה באפליקציות באמצעות אחד מ-OpenTelemetry SDKs או כשאתם משתמשים ב-OpenTelemetry Collector.
אנחנו ממליצים להשתמש ב-Telemetry API מהסיבה הבאה:
ממשק ה-API תואם לסביבת הקוד הפתוח OpenTelemetry, והמגבלות שלו לרוב נדיבות יותר מהמגבלות של Cloud Trace API, שהוא API קנייני של Google Cloud
נתוני העקבות מאוחסנים בפורמט שתואם בדרך כלל לקובצי הפרוטו שמוגדרים בפרוטוקול OTLP של OpenTelemetry. יכול להיות שחלק מהשדות יומרו מסוג נתונים ספציפי ל-OpenTelemetry לסוג נתונים של JSON לפני האחסון. מידע נוסף על פורמט האחסון זמין במאמר בנושא סכימה של נתוני מעקב.
האינסטרומנטציה שלכם לא מסתמכת על כלי ייצוא ספציפי ל- Google Cloud.
חלק מהתכונות, כמו מעקב אחר אפליקציות, מתבססות על מידע שזמין רק כששולחים נתוני מעקב ל-Telemetry API.
OpenTelemetry הוא פרויקט בקוד פתוח שנתמך על ידי Google. יש מהנדסים שמועסקים על ידי Google כדי לוודא שיש תמיכה בהטמעה של נתוני הטלמטריה שלכם ובהצגתם. Google CloudGoogle Cloud
Google Cloud Observability מוודא ש-Cloud Trace API מופעל בפרויקט לפני שהוא מאחסן נתוני מעקב. Google Cloud המשמעות היא שאם משביתים את Cloud Trace API, Google Cloud Observability מבטל את נתוני העקבות ששולחים אל Telemetry API.
שיטות מומלצות
כשמגדירים את האפליקציות לשליחת נתוני מעקב אלGoogle Cloud הפרויקט, מומלץ לבצע אחת מהפעולות הבאות:
- משתמשים בכלי לייצוא שכותב OTLP למאסף, ששולח את נתוני המעקב ל-Telemetry API.
- משתמשים ב-OTLP exporter בתהליך שנתמך על ידי ספריית OpenTelemetry ושולח נתוני טלמטריה ל-Telemetry API. אין כלי לאיסוף נתונים עם ההגדרה הזו.
מידע על השימוש ב-Telemetry API מופיע במאמר מעבר מ-Cloud Trace exporter לנקודת הקצה של OTLP.
אימות
צריך להגדיר את כלי הייצוא עם פרטי הכניסה שנדרשים לשליחת נתוני מעקב לפרויקט Google Cloud . לדוגמה, כדי להגדיר את כלי הייצוא באמצעותGoogle Cloud Application Default Credentials (ADC), מוסיפים לאפליקציה ספריית אימות של Google שספציפית לשפה. מידע נוסף וקוד לדוגמה זמינים במאמר הגדרת אימות.
Cloud Trace ומיקום הנתונים
אם אתם משתמשים ב-Assured Workloads כי יש לכם דרישות לגבי מיקום הנתונים או רמת השפעה 4 (IL4), אל תשתמשו ב-Telemetry API כדי לשלוח טווחים של מעקב לפרויקט שלכם.
איפה אפשר לראות את הנתונים שהועברו
אפשר להציג את נתוני העקבות באמצעות הדפים Trace Explorer ו-Log Analytics. מידע נוסף זמין במאמרים הבאים: