تزويد التطبيقات بأدوات OTel SDK
تعرّفوا على نظرة عامة على OTel SDKs لمختلف لغات البرمجة. وافهموا كيفية استخدامها لإنشاء السجلات والمقاييس والتتبّعات
تزويد التطبيقات بأدوات OTel SDK درس مجاني في System Observability: Logging, Metrics & Tracing (ELK + OpenTelemetry) على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في System Observability: Logging, Metrics & Tracing (ELK + OpenTelemetry)، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة System Observability: Logging, Metrics & Tracing (ELK + OpenTelemetry) 4 دروس في المجموع.
بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.
What are OTel SDKs?
OpenTelemetry SDKs are language-specific libraries that enable your applications to generate and export observability data. Think of them as the toolkit for making your code observable.
They provide the necessary APIs (Application Programming Interfaces) to capture logs, metrics, and traces directly from your application's runtime.
Role of OpenTelemetry SDKs
SDKs are crucial because they bridge the gap between your application code and the OpenTelemetry standard. They handle the complex work of:
- Collecting Data: Gathering raw observability signals like method calls or variable values.
- Processing Data: Enriching, filtering, and batching this data.
- Exporting Data: Sending the processed data to an observability backend (like Jaeger, Prometheus, or an ELK stack).
Key OTel SDK Components
An OpenTelemetry SDK typically includes several core components that work together:
- Providers: Such as
TracerProvider,MeterProvider, andLoggerProvider, which manage the creation of Tracers, Meters, and Loggers. - Processors/Readers: These define how collected data (spans, metrics, log records) is processed before being sent to an exporter.
- Exporters: Components that send the processed data to an external system, like a console or a remote endpoint.
Tracing with OTel SDKs
When you want to trace requests through your system, OpenTelemetry SDKs provide tools to create and manage spans. A span represents a single operation within a trace.
The SDK gives you a Tracer object, which you use to start new spans, set attributes on them, and link them to parent spans, effectively building a complete trace of a request's journey.
OTel Tracing Code Example
Here's a simple Python example showing how to initialize OpenTelemetry and create a basic trace with nested spans. We use a ConsoleSpanExporter to print spans to the console.
from opentelemetry import trace
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import ConsoleSpanExporter, SimpleSpanProcessor
# 1. Configure the TracerProvider
provider = TracerProvider()
processor = SimpleSpanProcessor(ConsoleSpanExporter())
provider.add_span_processor(processor)
trace.set_tracer_provider(provider)
# 2. Get a Tracer
tracer = trace.get_tracer(__name__)
# 3. Create a Span
with tracer.start_as_current_span("my-first-span"):
print("Inside the span!")
with tracer.start_as_current_span("child-span"):
print("Inside the child span!")
print("Tracing example finished.")Metrics with OTel SDKs
OpenTelemetry SDKs allow you to define and record various types of metrics. Metrics are numerical measurements captured over time, useful for aggregated views of system health and performance.
You obtain a Meter object from the SDK, which you then use to create different types of instruments, such as Counters (for incrementing values) or Gauges (for current values).
OTel Metrics Code Example
This Python example demonstrates how to set up OpenTelemetry for metrics and use a Meter to create and update a Counter. The ConsoleMetricExporter prints the collected metrics.
from opentelemetry import metrics
from opentelemetry.sdk.metrics import MeterProvider
from opentelemetry.sdk.metrics.export import ConsoleMetricExporter, PeriodicExportingMetricReader
# 1. Configure the MeterProvider
reader = PeriodicExportingMetricReader(ConsoleMetricExporter())
provider = MeterProvider(metric_readers=[reader])
metrics.set_meter_provider(provider)
# 2. Get a Meter
meter = metrics.get_meter(__name__)
# 3. Create a Counter instrument
counter = meter.create_counter(
"my_example_counter",
description="Counts how many times something happens"
)
# 4. Record a measurement
counter.add(1, {"key": "value"})
counter.add(2, {"another_key": "another_value"})
print("Metrics example finished. May take a moment to export.")Logging with OTel SDKs
OpenTelemetry SDKs also provide a way to capture and enrich logs. While traditional logging often focuses on plain text, OTel logs can be structured and correlated with traces and metrics.
The SDK offers a Logger (or integrates with existing logging frameworks) to create Log Records. These records can then be processed and exported alongside your traces and metrics, providing a unified view.
OTel Logging Code Example
This Python example shows how to integrate OpenTelemetry with the standard Python logging library. Logs emitted through the standard logger are then processed and exported by OTel.
import logging
from opentelemetry._logs import set_logger_provider
from opentelemetry.sdk._logs import LoggerProvider, LoggingHandler
from opentelemetry.sdk._logs.export import ConsoleLogExporter, SimpleLogRecordProcessor
# 1. Configure the LoggerProvider
provider = LoggerProvider()
processor = SimpleLogRecordProcessor(ConsoleLogExporter())
provider.add_log_record_processor(processor)
set_logger_provider(provider)
# 2. Get a Python standard logger
# and attach the OTel handler
handler = LoggingHandler(logger_provider=provider)
logging.getLogger().addHandler(handler)
logging.getLogger().setLevel(logging.INFO)
# 3. Emit a log record
logging.info("This is an info log from OTel SDK!")
logging.warning("A warning occurred.")
print("Logging example finished.")OTel SDKs Quick Check
OpenTelemetry SDKs are essential for instrumenting applications. Which of the following is NOT a core component or function provided by an OpenTelemetry SDK?
Recap: OTel SDKs
You've learned that OpenTelemetry SDKs are the foundational tools for instrumenting your applications across different programming languages.
- They provide the APIs to generate traces, metrics, and logs.
- They handle the processing and exporting of this data to your chosen observability backend.
- By using SDKs, you ensure your application's observability data adheres to the OpenTelemetry standard, making it portable and vendor-agnostic.
Next, you'll dive deeper into how to effectively instrument your applications.
الأسئلة الشائعة
هل درس «تزويد التطبيقات بأدوات OTel SDK» مجاني؟
نعم — نص درس «تزويد التطبيقات بأدوات OTel SDK» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة System Observability: Logging, Metrics & Tracing (ELK + OpenTelemetry)، انتقل إلى CoddyKit PRO. تتضمن دورة System Observability: Logging, Metrics & Tracing (ELK + OpenTelemetry) 4 دروس في المجموع.
ماذا ستتعلم في «تزويد التطبيقات بأدوات OTel SDK»؟
تعرّفوا على نظرة عامة على OTel SDKs لمختلف لغات البرمجة. وافهموا كيفية استخدامها لإنشاء السجلات والمقاييس والتتبّعات تتمرن على System Observability: Logging, Metrics & Tracing (ELK + OpenTelemetry) مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ System Observability: Logging, Metrics & Tracing (ELK + OpenTelemetry)؟
لا تُشترط خبرة سابقة. System Observability: Logging, Metrics & Tracing (ELK + OpenTelemetry) على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.
كم من الوقت يستغرق درس «تزويد التطبيقات بأدوات OTel SDK»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس System Observability: Logging, Metrics & Tracing (ELK + OpenTelemetry) هذا؟
نعم. كل درس في System Observability: Logging, Metrics & Tracing (ELK + OpenTelemetry) يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- معيار OpenTelemetry
- جامعات ومصدّرات OTel
- تزويد التطبيقات بأدوات OTel SDK
- الإشارات والاصطلاحات الدلالية