نقاط النهاية
أرسل نص الطلب بتنسيق
application/x-protobuf أو application/json. يمكنك ضغط نص الطلب باستخدام Content-Encoding: gzip.
أرسل مفتاح الاستيعاب الخاص بالمشروع في إحدى هاتين الترويستين:
x-logbrew-key: lbw_ingest_...Authorization: Bearer lbw_ingest_...
server للخدمة. أنواع المفاتيح موضّحة في أنواع مفاتيح المشروع.
اضبط OpenTelemetry SDK
تقرأ حزم OpenTelemetry SDK متغيرات البيئة القياسيةOTEL_*. اضبط نقطة النهاية الأساسية. وتضيف الحزمة /v1/logs و/v1/traces و/v1/metrics بنفسها.
قلّل تأخير التصدير
تجمع حزمة OpenTelemetry SDK البيانات في دفعات (batch)، وترسل كل دفعة على فترات منتظمة. ولا يستطيع LogBrew عرض البيانات إلا بعد أن ترسلها الحزمة. وتستخدم الحزمة التأخيرات التالية افتراضيًا:
يضبط المثال أعلاه تأخير الـ Spans والسجلات على
1000 ملي ثانية. وبهذه القيمة يمكنك قراءة الـ Spans والسجلات في LogBrew خلال ثانيتين تقريبًا. ويؤدي التأخير الأقصر إلى إرسال طلبات أكثر. ولرؤية المقاييس في وقت أبكر، اخفض قيمة OTEL_METRIC_EXPORT_INTERVAL.
اضبط OpenTelemetry Collector
أضف أداة تصديرotlphttp. اضبط نقطة النهاية الأساسية. وتضيف أداة التصدير مسار الإشارة بنفسها.
batch، فأبقِ قيمة timeout عند 1s أو أقل. والقيمة الافتراضية هي 200ms. وإذا كانت حزمة OpenTelemetry SDK ترسل البيانات إلى Collector، فاضبط تأخيرات الحزمة في ذلك التطبيق أيضًا.
كيف يقرأ LogBrew بيانات OTLP
يقرأ LogBrew سمات المورد التالية ويضعها في سياق الحدث:
تبقى سمات المورد الأخرى ونطاق أداة القياس (instrumentation scope) في البيانات الوصفية لكل حدث.
يرفض LogBrew مجاميع التغيّر (delta) غير الرتيبة. ويحتفظ قيد السجل والـ Span بمعرّف التتبّع ومعرّف الـ Span، لذلك تظهر السجلات داخل تتبّعها.
يستبدل LogBrew بيانات الاعتماد بالقيمة
[redacted] قبل تخزين البيانات. ينطبق ذلك على قيم السمات التي تدل مفاتيحها على بيانات اعتماد، مثل authorization وcookie وpassword وsecret وapi_key، أو أي مفتاح ينتهي بـ token. وينطبق أيضًا على process.command_args وprocess.command_line، وعلى اسم المستخدم وكلمة المرور في عنوان URL، وعلى قيم الاستعلام في عنوان URL مثل token وcode وkey وsignature. لا ترسل أسرارًا أخرى.
الحدود
تنطبق أيضًا حدود المعدّل وحدود الخطة الخاصة ببيانات SDK. إذا احتوى الطلب على عدد كبير جدًا من القيود، يخزّن LogBrew القيود الأولى ويرفض الباقي. أرسل دفعات أصغر.
الاستجابات
يرد LogBrew بترميز الطلب نفسه.
عندما يبلغ حسابك حد خطته، يرد LogBrew بالحالة
200 ويرفض كل القيود. وتذكر الرسالة وقت إعادة الضبط. ولا تعيد أداة التصدير المحاولة قبل إعادة الضبط.
يحتسب LogBrew القيود المرفوضة في استخدام الحساب. وتظهر في sdk_dropped_events بالسبب otlp_rejected_record، أو usage_limit_exceeded عند بلوغ حد الخطة. ولا تُحتسب القيود المرفوضة ضمن الاستخدام.
لا يخزّن LogBrew قيود الطلب المعاد إرساله مرة أخرى. ويتعرّف على القيد المعاد إرساله من محتواه.
