{"id":31797,"date":"2024-11-27T11:50:13","date_gmt":"2024-11-27T03:50:13","guid":{"rendered":"https:\/\/www.yunshan.net\/blog\/?p=23257"},"modified":"2024-11-27T11:50:13","modified_gmt":"2024-11-27T03:50:13","slug":"opentelemetry%e5%9f%ba%e7%a1%80%e6%95%99%e7%a8%8b%ef%bc%9a%e5%bc%80%e5%90%af%e5%ba%94%e7%94%a8%e8%a7%82%e6%b5%8b%e4%b9%8b%e9%97%a8","status":"publish","type":"post","link":"https:\/\/www.yunshan.net\/blog\/archives\/31797.html","title":{"rendered":"OpenTelemetry\u57fa\u7840\u6559\u7a0b\uff1a\u5f00\u542f\u5e94\u7528\u89c2\u6d4b\u4e4b\u95e8"},"content":{"rendered":"

\t\t\t\tOpenTelemetry<\/a>\u662f\u4e00\u4e2a\u5f00\u6e90\u7684\u89c2\u6d4b\u5de5\u5177\uff0c\u65e8\u5728\u5e2e\u52a9\u5f00\u53d1\u4eba\u5458\u66f4\u597d\u5730\u7406\u89e3\u548c\u76d1\u63a7\u5176\u5e94\u7528\u7a0b\u5e8f\u7684\u6027\u80fd\u548c\u884c\u4e3a\u3002\u968f\u7740\u5fae\u670d\u52a1\u67b6\u6784\u548c\u4e91\u539f\u751f\u5e94\u7528\u7684\u666e\u53ca\uff0c\u5e94\u7528\u89c2\u6d4b\u53d8\u5f97\u6108\u53d1\u91cd\u8981\u3002OpenTelemetry<\/a>\u63d0\u4f9b\u4e86\u4e00\u5957\u7edf\u4e00\u7684API\u3001SDK\u548c\u5de5\u5177\uff0c\u4f7f\u5f97\u6536\u96c6\u3001\u5904\u7406\u548c\u5bfc\u51fa\u9065\u6d4b\u6570\u636e\u53d8\u5f97\u7b80\u5355\u800c\u9ad8\u6548\u3002\u672c\u6587\u5c06\u8be6\u7ec6\u4ecb\u7ecdOpenTelemetry\u7684\u57fa\u7840\u77e5\u8bc6\uff0c\u5e2e\u52a9\u8bfb\u8005\u5f00\u542f\u5e94\u7528\u89c2\u6d4b\u4e4b\u95e8\u3002<\/p>\n\n\n\n\n

\u4ec0\u4e48\u662fOpenTelemetry\uff1f<\/h3>\n\n\n\n\n

OpenTelemetry\u662f\u7531CNCF\uff08\u4e91\u539f\u751f\u8ba1\u7b97\u57fa\u91d1\u4f1a\uff09\u6258\u7ba1\u7684\u4e00\u4e2a\u9879\u76ee\uff0c\u65e8\u5728\u6807\u51c6\u5316\u548c\u7b80\u5316\u5e94\u7528\u89c2\u6d4b\u3002\u5b83\u63d0\u4f9b\u4e86\u4e00\u5957\u7edf\u4e00\u7684API\u548cSDK\uff0c\u652f\u6301\u591a\u79cd\u7f16\u7a0b\u8bed\u8a00\uff0c\u4f7f\u5f97\u5f00\u53d1\u4eba\u5458\u53ef\u4ee5\u8f7b\u677e\u5730\u6536\u96c6\u3001\u5904\u7406\u548c\u5bfc\u51fa\u9065\u6d4b\u6570\u636e\uff0c\u5982\u8ffd\u8e2a\uff08Tracing\uff09\u3001\u6307\u6807\uff08Metrics\uff09\u548c\u65e5\u5fd7\uff08Logging\uff09\u3002<\/p>\n\n\n\n\n\n\n\n\n

<\/p>\n\n\n\n\n\n\n\n\n\n

OpenTelemetry\u7684\u6838\u5fc3\u7ec4\u4ef6<\/h3>\n\n\n\n\n

OpenTelemetry\u7684\u6838\u5fc3\u7ec4\u4ef6\u5305\u62ec\uff1a<\/p>\n\n\n\n\n

    \n\n\n
  1. API<\/strong>: \u63d0\u4f9b\u7528\u4e8e\u751f\u6210\u548c\u6536\u96c6\u9065\u6d4b\u6570\u636e\u7684\u63a5\u53e3\u3002<\/li>\n\n\n\n\n
  2. SDK<\/strong>: \u5b9e\u73b0API\u7684\u5177\u4f53\u903b\u8f91\uff0c\u8d1f\u8d23\u6570\u636e\u7684\u6536\u96c6\u3001\u5904\u7406\u548c\u5bfc\u51fa\u3002<\/li>\n\n\n\n\n
  3. \u5bfc\u51fa\u5668\uff08Exporters\uff09<\/strong>: \u5c06\u6536\u96c6\u5230\u7684\u9065\u6d4b\u6570\u636e\u5bfc\u51fa\u5230\u540e\u7aef\u5b58\u50a8\u6216\u5206\u6790\u7cfb\u7edf\u3002<\/li>\n\n\n\n\n
  4. \u4eea\u8868\uff08Instruments\uff09<\/strong>: \u7528\u4e8e\u751f\u6210\u7279\u5b9a\u7c7b\u578b\u9065\u6d4b\u6570\u636e\u7684\u5de5\u5177\uff0c\u5982\u8ffd\u8e2a span\u3001\u6307\u6807\u8ba1\u6570\u5668\u7b49\u3002<\/li>\n\n\n\n\n
  5. \u5904\u7406\u5668\uff08Processors\uff09<\/strong>: \u5bf9\u6536\u96c6\u5230\u7684\u9065\u6d4b\u6570\u636e\u8fdb\u884c\u5904\u7406\u7684\u7ec4\u4ef6\uff0c\u5982\u91c7\u6837\u3001\u805a\u5408\u7b49\u3002<\/li>\n\n\n<\/ol>\n\n\n\n\n

    \u5b89\u88c5\u548c\u914d\u7f6eOpenTelemetry<\/h3>\n\n\n\n\n

    \u9996\u5148\uff0c\u6211\u4eec\u9700\u8981\u5728\u5e94\u7528\u7a0b\u5e8f\u4e2d\u5b89\u88c5OpenTelemetry\u7684SDK\u3002\u4ee5Python\u4e3a\u4f8b\uff0c\u53ef\u4ee5\u901a\u8fc7pip\u5b89\u88c5\uff1a<\/p>\n\n\n\n\n

    pip install opentelemetry-sdk
    \n<\/code><\/pre>\n\n\n\n\n
    \u63a5\u4e0b\u6765\uff0c\u6211\u4eec\u9700\u8981\u914d\u7f6eSDK\uff0c\u5305\u62ec\u8bbe\u7f6e\u5bfc\u51fa\u5668\u548c\u5904\u7406\u5668\u3002\u4ee5\u4e0b\u662f\u4e00\u4e2a\u7b80\u5355\u7684\u914d\u7f6e\u793a\u4f8b\uff1a<\/p>\n\n\n\n\n
    from opentelemetry import trace
    \nfrom opentelemetry.sdk.trace import TracerProvider
    \nfrom opentelemetry.sdk.trace.export import BatchSpanProcessor
    \nfrom opentelemetry.exporter.otlp.proto.grpc.trace_exporter import OTLPSpanExporter
    \n
    \n# \u8bbe\u7f6eTracerProvider
    \nprovider = TracerProvider()
    \ntrace.set_tracer_provider(provider)
    \n
    \n# \u8bbe\u7f6eOTLP\u5bfc\u51fa\u5668
    \nexporter = OTLPSpanExporter(endpoint="localhost:4317", insecure=True)
    \nprocessor = BatchSpanProcessor(exporter)
    \nprovider.add_span_processor(processor)
    \n
    \n# \u83b7\u53d6Tracer
    \ntracer = trace.get_tracer(__name__)
    \n<\/code><\/pre>\n\n\n\n\n
    \u8ffd\u8e2a\uff08Tracing\uff09<\/h3>\n\n\n\n\n
    \u8ffd\u8e2a\u662fOpenTelemetry\u4e2d\u6700\u6838\u5fc3\u7684\u529f\u80fd\u4e4b\u4e00\uff0c\u7528\u4e8e\u8bb0\u5f55\u8bf7\u6c42\u5728\u7cfb\u7edf\u4e2d\u7684\u6d41\u8f6c\u8fc7\u7a0b\u3002\u4e00\u4e2a\u8ffd\u8e2a\u7531\u591a\u4e2aspan\u7ec4\u6210\uff0c\u6bcf\u4e2aspan\u4ee3\u8868\u4e00\u4e2a\u64cd\u4f5c\u6216\u670d\u52a1\u8c03\u7528\u3002<\/p>\n\n\n\n\n
    \u521b\u5efaSpan<\/h4>\n\n\n\n\n
    \u4ee5\u4e0b\u662f\u4e00\u4e2a\u521b\u5efaspan\u7684\u793a\u4f8b\uff1a<\/p>\n\n\n\n\n
    with tracer.start_as_current_span("my-span"):
    \n    # \u6267\u884c\u4e00\u4e9b\u64cd\u4f5c
    \n    print("Hello, OpenTelemetry!")
    \n<\/code><\/pre>\n\n\n\n\n
    Span\u7684\u5c5e\u6027\u548c\u4e8b\u4ef6<\/h4>\n\n\n\n\n
    Span\u53ef\u4ee5\u5305\u542b\u5c5e\u6027\u548c\u4e8b\u4ef6\uff0c\u7528\u4e8e\u8bb0\u5f55\u66f4\u591a\u7684\u4e0a\u4e0b\u6587\u4fe1\u606f\u3002\u4ee5\u4e0b\u662f\u4e00\u4e2a\u6dfb\u52a0\u5c5e\u6027\u548c\u4e8b\u4ef6\u7684\u793a\u4f8b\uff1a<\/p>\n\n\n\n\n
    with tracer.start_as_current_span("my-span") as span:
    \n    span.set_attribute("my-attribute", "value")
    \n    span.add_event("my-event", {"event-attribute": "event-value"})
    \n    # \u6267\u884c\u4e00\u4e9b\u64cd\u4f5c
    \n    print("Hello, OpenTelemetry!")
    \n<\/code><\/pre>\n\n\n\n\n
    \u6307\u6807\uff08Metrics\uff09<\/h3>\n\n\n\n\n
    \u6307\u6807\u7528\u4e8e\u8bb0\u5f55\u5e94\u7528\u7a0b\u5e8f\u7684\u6027\u80fd\u6570\u636e\uff0c\u5982\u8bf7\u6c42\u6b21\u6570\u3001\u54cd\u5e94\u65f6\u95f4\u7b49\u3002OpenTelemetry\u652f\u6301\u591a\u79cd\u6307\u6807\u7c7b\u578b\uff0c\u5305\u62ec\u8ba1\u6570\u5668\uff08Counter\uff09\u3001\u76f4\u65b9\u56fe\uff08Histogram\uff09\u548c\u8ba1\u91cf\u5668\uff08Gauge\uff09\u3002<\/p>\n\n\n\n\n
    \u521b\u5efa\u8ba1\u6570\u5668<\/h4>\n\n\n\n\n
    \u4ee5\u4e0b\u662f\u4e00\u4e2a\u521b\u5efa\u8ba1\u6570\u5668\u7684\u793a\u4f8b\uff1a<\/p>\n\n\n\n\n
    from opentelemetry import metrics
    \nfrom opentelemetry.sdk.metrics import MeterProvider
    \nfrom opentelemetry.sdk.metrics.export import ConsoleMetricsExporter, PeriodicExportingMetricReader
    \n
    \n# \u8bbe\u7f6eMeterProvider
    \nprovider = MeterProvider()
    \nmetrics.set_meter_provider(provider)
    \n
    \n# \u8bbe\u7f6e\u5bfc\u51fa\u5668
    \nexporter = ConsoleMetricsExporter()
    \nreader = PeriodicExportingMetricReader(exporter)
    \nprovider.add_metric_reader(reader)
    \n
    \n# \u83b7\u53d6Meter
    \nmeter = metrics.get_meter(__name__)
    \n
    \n# \u521b\u5efa\u8ba1\u6570\u5668
    \ncounter = meter.create_counter(
    \n    name="my-counter",
    \n    description="This is a simple counter",
    \n)
    \n
    \n# \u8bb0\u5f55\u6307\u6807
    \ncounter.add(1, {"attribute": "value"})
    \n<\/code><\/pre>\n\n\n\n\n
    \u65e5\u5fd7\uff08Logging\uff09<\/h3>\n\n\n\n\n
    \u867d\u7136OpenTelemetry\u7684\u4e3b\u8981\u5173\u6ce8\u70b9\u662f\u8ffd\u8e2a\u548c\u6307\u6807\uff0c\u4f46\u5b83\u4e5f\u63d0\u4f9b\u4e86\u4e00\u4e9b\u65e5\u5fd7\u96c6\u6210\u529f\u80fd\uff0c\u4f7f\u5f97\u65e5\u5fd7\u6570\u636e\u53ef\u4ee5\u4e0e\u8ffd\u8e2a\u548c\u6307\u6807\u6570\u636e\u5173\u8054\u8d77\u6765\u3002<\/p>\n\n\n\n\n
    \u96c6\u6210\u65e5\u5fd7<\/h4>\n\n\n\n\n
    \u4ee5\u4e0b\u662f\u4e00\u4e2a\u96c6\u6210\u65e5\u5fd7\u7684\u793a\u4f8b\uff1a<\/p>\n\n\n\n\n
    import logging
    \nfrom opentelemetry import trace
    \nfrom opentelemetry.sdk.trace import TracerProvider
    \nfrom opentelemetry.sdk.trace.export import BatchSpanProcessor
    \nfrom opentelemetry.exporter.otlp.proto.grpc.trace_exporter import OTLPSpanExporter
    \nfrom opentelemetry.instrumentation.logging import LoggingInstrumentor
    \n
    \n# \u8bbe\u7f6eTracerProvider
    \nprovider = TracerProvider()
    \ntrace.set_tracer_provider(provider)
    \n
    \n# \u8bbe\u7f6eOTLP\u5bfc\u51fa\u5668
    \nexporter = OTLPSpanExporter(endpoint="localhost:4317", insecure=True)
    \nprocessor = BatchSpanProcessor(exporter)
    \nprovider.add_span_processor(processor)
    \n
    \n# \u96c6\u6210\u65e5\u5fd7
    \nLoggingInstrumentor().instrument()
    \n
    \n# \u83b7\u53d6Tracer
    \ntracer = trace.get_tracer(__name__)
    \n
    \n# \u4f7f\u7528\u65e5\u5fd7
    \nlogger = logging.getLogger(__name__)
    \nlogger.setLevel(logging.INFO)
    \n
    \nwith tracer.start_as_current_span("my-span"):
    \n    logger.info("This is a log message")
    \n<\/code><\/pre>\n\n\n\n\n
    OpenTelemetry\u7684\u751f\u6001\u7cfb\u7edf<\/h3>\n\n\n\n\n
    OpenTelemetry\u4e0d\u4ec5\u63d0\u4f9b\u4e86\u57fa\u7840\u7684API\u548cSDK\uff0c\u8fd8\u62e5\u6709\u4e00\u4e2a\u5e9e\u5927\u7684\u751f\u6001\u7cfb\u7edf\uff0c\u5305\u62ec\u591a\u79cd\u8bed\u8a00\u7684\u5b9e\u73b0\u3001\u4e30\u5bcc\u7684\u5bfc\u51fa\u5668\u548c\u96c6\u6210\u5de5\u5177\u3002<\/p>\n\n\n\n\n
    \u591a\u8bed\u8a00\u652f\u6301<\/h4>\n\n\n\n\n
    OpenTelemetry\u652f\u6301\u591a\u79cd\u7f16\u7a0b\u8bed\u8a00\uff0c\u5305\u62ec\u4f46\u4e0d\u9650\u4e8e\uff1a<\/p>\n\n\n\n\n