{"id":31763,"date":"2024-11-27T10:22:06","date_gmt":"2024-11-27T02:22:06","guid":{"rendered":"https:\/\/www.yunshan.net\/blog\/?p=23092"},"modified":"2024-11-27T10:22:06","modified_gmt":"2024-11-27T02:22:06","slug":"opentelemetry%e5%85%a5%e9%97%a8%e6%8c%87%e5%8d%97%ef%bc%9a%e4%b8%ba%e5%bc%80%e5%8f%91%e8%80%85%e8%a7%a3%e9%94%81%e7%9b%91%e6%8e%a7%e5%a5%a5%e7%a7%98","status":"publish","type":"post","link":"https:\/\/www.yunshan.net\/blog\/archives\/31763.html","title":{"rendered":"OpenTelemetry\u5165\u95e8\u6307\u5357\uff1a\u4e3a\u5f00\u53d1\u8005\u89e3\u9501\u76d1\u63a7\u5965\u79d8"},"content":{"rendered":"

\t\t\t\t\u5728\u73b0\u4ee3\u8f6f\u4ef6\u5f00\u53d1\u4e2d\uff0c\u76d1\u63a7\u548c\u53ef\u89c2\u6d4b\u6027\u662f\u786e\u4fdd\u5e94\u7528\u7a0b\u5e8f\u7a33\u5b9a\u8fd0\u884c\u548c\u9ad8\u6548\u6027\u80fd\u7684\u5173\u952e\u56e0\u7d20\u3002OpenTelemetry<\/a>\u4f5c\u4e3a\u4e00\u79cd\u5f00\u6e90\u7684\u76d1\u63a7\u89e3\u51b3\u65b9\u6848\uff0c\u9010\u6e10\u6210\u4e3a\u5f00\u53d1\u8005\u4eec\u7684\u65b0\u5ba0\u3002\u672c\u6587\u5c06\u8be6\u7ec6\u4ecb\u7ecdOpenTelemetry<\/a>\u7684\u5165\u95e8\u77e5\u8bc6\uff0c\u5e2e\u52a9\u5f00\u53d1\u8005\u89e3\u9501\u76d1\u63a7\u7684\u5965\u79d8\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\u5f00\u6e90\u9879\u76ee\uff0c\u65e8\u5728\u63d0\u4f9b\u4e00\u5957\u7edf\u4e00\u7684\u5de5\u5177\u548c\u6807\u51c6\uff0c\u7528\u4e8e\u6536\u96c6\u3001\u5904\u7406\u548c\u5bfc\u51fa\u5e94\u7528\u7a0b\u5e8f\u7684\u9065\u6d4b\u6570\u636e\u3002\u9065\u6d4b\u6570\u636e\u5305\u62ec\u6307\u6807\uff08Metrics\uff09\u3001\u65e5\u5fd7\uff08Logs\uff09\u548c\u8ffd\u8e2a\uff08Traces\uff09\uff0c\u8fd9\u4e9b\u6570\u636e\u5bf9\u4e8e\u7406\u89e3\u548c\u4f18\u5316\u5e94\u7528\u7a0b\u5e8f\u7684\u6027\u80fd\u81f3\u5173\u91cd\u8981\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\u7531\u4ee5\u4e0b\u51e0\u4e2a\u6838\u5fc3\u7ec4\u4ef6\u7ec4\u6210\uff1a<\/p>\n\n\n\n\n

    \n\n\n
  1. APIs\u548cSDKs<\/strong>\uff1a\u63d0\u4f9b\u4e86\u7528\u4e8e\u751f\u6210\u548c\u6536\u96c6\u9065\u6d4b\u6570\u636e\u7684\u63a5\u53e3\u548c\u5b9e\u73b0\u3002<\/li>\n\n\n\n\n
  2. \u5bfc\u51fa\u5668\uff08Exporters\uff09<\/strong>\uff1a\u5c06\u6536\u96c6\u5230\u7684\u9065\u6d4b\u6570\u636e\u53d1\u9001\u5230\u540e\u7aef\u5b58\u50a8\u6216\u5206\u6790\u7cfb\u7edf\u3002<\/li>\n\n\n\n\n
  3. \u6536\u96c6\u5668\uff08Collector\uff09<\/strong>\uff1a\u4e00\u4e2a\u53ef\u914d\u7f6e\u7684\u4ee3\u7406\uff0c\u7528\u4e8e\u63a5\u6536\u3001\u5904\u7406\u548c\u8f6c\u53d1\u9065\u6d4b\u6570\u636e\u3002<\/li>\n\n\n\n\n
  4. \u4eea\u8868\u677f\u548c\u53ef\u89c6\u5316\u5de5\u5177<\/strong>\uff1a\u7528\u4e8e\u5c55\u793a\u548c\u5206\u6790\u9065\u6d4b\u6570\u636e\u7684\u5de5\u5177\u3002<\/li>\n\n\n<\/ol>\n\n\n\n\n

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

    1. \u5b89\u88c5OpenTelemetry SDK<\/h4>\n\n\n\n\n

    \u9996\u5148\uff0c\u4f60\u9700\u8981\u6839\u636e\u4f60\u7684\u7f16\u7a0b\u8bed\u8a00\u9009\u62e9\u76f8\u5e94\u7684OpenTelemetry SDK\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
    \u5bf9\u4e8e\u5176\u4ed6\u8bed\u8a00\uff0c\u5982Java\u3001Go\u3001Node.js\u7b49\uff0c\u4e5f\u6709\u76f8\u5e94\u7684\u5b89\u88c5\u65b9\u5f0f\u3002<\/p>\n\n\n\n\n
    2. \u914d\u7f6e\u5bfc\u51fa\u5668<\/h4>\n\n\n\n\n
    \u5bfc\u51fa\u5668\u8d1f\u8d23\u5c06\u9065\u6d4b\u6570\u636e\u53d1\u9001\u5230\u540e\u7aef\u7cfb\u7edf\u3002\u5e38\u89c1\u7684\u5bfc\u51fa\u5668\u5305\u62ecJaeger\u3001Prometheus<\/a>\u3001Zipkin\u7b49\u3002\u4ee5\u4e0b\u662f\u4e00\u4e2a\u914d\u7f6eJaeger\u5bfc\u51fa\u5668\u7684\u793a\u4f8b\uff1a<\/p>\n\n\n\n\n
    from opentelemetry import trace
    \nfrom opentelemetry.exporter.jaeger.thrift import JaegerExporter
    \nfrom opentelemetry.sdk.resources import SERVICE_NAME, Resource
    \nfrom opentelemetry.sdk.trace import TracerProvider
    \nfrom opentelemetry.sdk.trace.export import BatchSpanProcessor
    \n
    \n# \u8bbe\u7f6e\u8d44\u6e90\u4fe1\u606f
    \nresource = Resource(attributes={SERVICE_NAME: "my-service"})
    \n
    \n# \u521b\u5efaTracerProvider
    \nprovider = TracerProvider(resource=resource)
    \ntrace.set_tracer_provider(provider)
    \n
    \n# \u521b\u5efaJaeger\u5bfc\u51fa\u5668
    \njaeger_exporter = JaegerExporter(
    \n    agent_host_name="localhost",
    \n    agent_port=6831,
    \n)
    \n
    \n# \u521b\u5efaSpan\u5904\u7406\u5668\u5e76\u6dfb\u52a0\u5230TracerProvider
    \nspan_processor = BatchSpanProcessor(jaeger_exporter)
    \nprovider.add_span_processor(span_processor)
    \n
    \n# \u83b7\u53d6Tracer
    \ntracer = trace.get_tracer(__name__)
    \n<\/code><\/pre>\n\n\n\n\n
    3. \u914d\u7f6e\u6536\u96c6\u5668<\/h4>\n\n\n\n\n
    OpenTelemetry\u6536\u96c6\u5668\u662f\u4e00\u4e2a\u72ec\u7acb\u8fd0\u884c\u7684\u670d\u52a1\uff0c\u7528\u4e8e\u63a5\u6536\u548c\u5904\u7406\u9065\u6d4b\u6570\u636e\u3002\u4f60\u53ef\u4ee5\u901a\u8fc7Docker\u6216\u76f4\u63a5\u7f16\u8bd1\u6e90\u7801\u6765\u90e8\u7f72\u6536\u96c6\u5668\u3002<\/p>\n\n\n\n\n
    docker run -d --name otel-collector \\
    \n  -p 4317:4317 \\
    \n  -p 55681:55681 \\
    \n  otel\/opentelemetry-collector:latest
    \n<\/code><\/pre>\n\n\n\n\n
    \u914d\u7f6e\u6587\u4ef6otel-collector-config.yaml<\/code>\u793a\u4f8b\u5982\u4e0b\uff1a<\/p>\n\n\n\n\n
    receivers:
    \n  otlp:
    \n    protocols:
    \n      grpc:
    \n      http:
    \n
    \nprocessors:
    \n  batch:
    \n
    \nexporters:
    \n  jaeger:
    \n    endpoint: "localhost:6831"
    \n      Prometheus<\/a>:
    \n    endpoint: "0.0.0.0:8889"
    \n
    \nservice:
    \n  pipelines:
    \n    traces:
    \n      receivers: [otlp]
    \n      processors: [batch]
    \n      exporters: [jaeger]
    \n    metrics:
    \n      receivers: [otlp]
    \n      processors: [batch]
    \n      exporters: [prometheus]
    \n<\/code><\/pre>\n\n\n\n\n
    \u751f\u6210\u9065\u6d4b\u6570\u636e<\/h3>\n\n\n\n\n
    1. \u8ffd\u8e2a\uff08Traces\uff09<\/h4>\n\n\n\n\n
    \u8ffd\u8e2a\u7528\u4e8e\u8bb0\u5f55\u8bf7\u6c42\u5728\u7cfb\u7edf\u4e2d\u7684\u6d41\u8f6c\u8fc7\u7a0b\u3002\u4ee5\u4e0b\u662f\u4e00\u4e2a\u751f\u6210\u8ffd\u8e2a\u6570\u636e\u7684\u793a\u4f8b\uff1a<\/p>\n\n\n\n\n
    from opentelemetry import trace
    \n
    \n# \u83b7\u53d6Tracer
    \ntracer = trace.get_tracer(__name__)
    \n
    \n# \u521b\u5efa\u4e00\u4e2aSpan
    \nwith tracer.start_as_current_span("my-span"):
    \n    # \u6267\u884c\u4e1a\u52a1\u903b\u8f91
    \n    print("Hello, OpenTelemetry!")
    \n<\/code><\/pre>\n\n\n\n\n
    2. \u6307\u6807\uff08Metrics\uff09<\/h4>\n\n\n\n\n
    \u6307\u6807\u7528\u4e8e\u8bb0\u5f55\u5e94\u7528\u7a0b\u5e8f\u7684\u6027\u80fd\u6570\u636e\u3002\u4ee5\u4e0b\u662f\u4e00\u4e2a\u751f\u6210\u6307\u6807\u6570\u636e\u7684\u793a\u4f8b\uff1a<\/p>\n\n\n\n\n
    from opentelemetry import metrics
    \n
    \n# \u83b7\u53d6Meter
    \nmeter = metrics.get_meter(__name__)
    \n
    \n# \u521b\u5efa\u4e00\u4e2a\u8ba1\u6570\u5668
    \ncounter = meter.create_counter(
    \n    "my_counter",
    \n    description="Example of a counter",
    \n)
    \n
    \n# \u8bb0\u5f55\u6307\u6807
    \ncounter.add(1, {"key": "value"})
    \n<\/code><\/pre>\n\n\n\n\n
    3. \u65e5\u5fd7\uff08Logs\uff09<\/h4>\n\n\n\n\n
    OpenTelemetry\u4e5f\u652f\u6301\u65e5\u5fd7\u6570\u636e\u7684\u6536\u96c6\uff0c\u4f46\u9700\u8981\u4e0e\u73b0\u6709\u7684\u65e5\u5fd7\u5e93\u7ed3\u5408\u4f7f\u7528\u3002\u4ee5\u4e0b\u662f\u4e00\u4e2a\u4e0ePython\u6807\u51c6\u65e5\u5fd7\u5e93\u7ed3\u5408\u7684\u793a\u4f8b\uff1a<\/p>\n\n\n\n\n
    import logging
    \nfrom opentelemetry import logs
    \n
    \n# \u83b7\u53d6Logger
    \nlogger = logging.getLogger(__name__)
    \n
    \n# \u914d\u7f6eOpenTelemetry\u65e5\u5fd7\u5904\u7406\u5668
    \nlogs.set_logger_provider(LoggerProvider())
    \notel_logger = logs.get_logger(__name__)
    \n
    \n# \u8bb0\u5f55\u65e5\u5fd7
    \nlogger.info("This is an info log")
    \notel_logger.info("This is an OpenTelemetry info log")
    \n<\/code><\/pre>\n\n\n\n\n
    \u6570\u636e\u7684\u53ef\u89c6\u5316\u548c\u5206\u6790<\/h3>\n\n\n\n\n
    \u6536\u96c6\u5230\u7684\u9065\u6d4b\u6570\u636e\u9700\u8981\u901a\u8fc7\u53ef\u89c6\u5316\u5de5\u5177\u8fdb\u884c\u5206\u6790\u3002\u4ee5\u4e0b\u662f\u4e00\u4e9b\u5e38\u89c1\u7684\u53ef\u89c6\u5316\u5de5\u5177\uff1a<\/p>\n\n\n\n\n
      \n\n\n
    1. Jaeger<\/strong>\uff1a\u7528\u4e8e\u8ffd\u8e2a\u6570\u636e\u7684\u53ef\u89c6\u5316\u3002<\/li>\n\n\n\n\n
    2. Prometheus\u548cGrafana<\/strong>\uff1a\u7528\u4e8e\u6307\u6807\u6570\u636e\u7684\u53ef\u89c6\u5316\u548c\u62a5\u8b66\u3002<\/li>\n\n\n\n\n
    3. ELK Stack\uff08Elasticsearch, Logstash, Kibana\uff09<\/strong>\uff1a\u7528\u4e8e\u65e5\u5fd7\u6570\u636e\u7684\u5206\u6790\u548c\u53ef\u89c6\u5316\u3002<\/li>\n\n\n<\/ol>\n\n\n\n\n
      \u9ad8\u7ea7\u7279\u6027<\/h3>\n\n\n\n\n
      1. \u81ea\u52a8instrumentation<\/h4>\n\n\n\n\n
      OpenTelemetry\u652f\u6301\u81ea\u52a8instrumentation\uff0c\u65e0\u9700\u4fee\u6539\u4ee3\u7801\u5373\u53ef\u81ea\u52a8\u6536\u96c6\u9065\u6d4b\u6570\u636e\u3002\u4ee5Python\u4e3a\u4f8b\uff0c\u53ef\u4ee5\u4f7f\u7528opentelemetry-instrumentation<\/code>\u5305\uff1a<\/p>\n\n\n\n\n
      pip install opentelemetry-instrumentation
      \n<\/code><\/pre>\n\n\n\n\n
      \u7136\u540e\u5728\u4ee3\u7801\u4e2d\u914d\u7f6e\u81ea\u52a8instrumentation\uff1a<\/p>\n\n\n\n\n
      from opentelemetry.instrumentation.auto_instrumentation import setup
      \n
      \nsetup()
      \n<\/code><\/pre>\n\n\n\n\n
      2. \u8d44\u6e90\u548c\u5c5e\u6027<\/h4>\n\n\n\n\n
      \u8d44\u6e90\u548c\u5c5e\u6027\u7528\u4e8e\u4e3a\u9065\u6d4b\u6570\u636e\u6dfb\u52a0\u989d\u5916\u7684\u4e0a\u4e0b\u6587\u4fe1\u606f\u3002\u4ee5\u4e0b\u662f\u4e00\u4e2a\u793a\u4f8b\uff1a<\/p>\n\n\n\n\n
      from opentelemetry.sdk.resources import Resource
      \n
      \nresource = Resource(attributes={
      \n    "service.name": "my-service",
      \n    "service.instance.id": "instance-123",
      \n})
      \n
      \nprovider = TracerProvider(resource=resource)
      \ntrace.set_tracer_provider(provider)
      \n<\/code><\/pre>\n\n\n\n\n
      3. Context Propagation<\/h4>\n\n\n\n\n
      Context Propagation\u7528\u4e8e\u5728\u4e0d\u540c\u670d\u52a1\u548c\u7ec4\u4ef6\u4e4b\u95f4\u4f20\u9012\u8ffd\u8e2a\u4e0a\u4e0b\u6587\u3002\u4ee5\u4e0b\u662f\u4e00\u4e2a\u793a\u4f8b\uff1a<\/p>\n\n\n\n\n
      from opentelemetry import context, trace
      \n
      \n# \u83b7\u53d6\u5f53\u524d\u8ffd\u8e2a\u4e0a\u4e0b\u6587
      \ncurrent_context = context.get_current()
      \n
      \n# \u521b\u5efa\u4e00\u4e2a\u65b0\u7684Span
      \nwith tracer.start_as_current_span("my-span", context=current_context):
      \n    # \u6267\u884c\u4e1a\u52a1\u903b\u8f91
      \n    print("Hello, OpenTelemetry!")
      \n<\/code><\/pre>\n\n\n\n\n
      \u6700\u4f73\u5b9e\u8df5<\/h3>\n\n\n\n\n
        \n\n\n
      1. \u9010\u6b65\u5f15\u5165<\/strong>\uff1a\u5148\u4ece\u5355\u4e2a\u670d\u52a1\u6216\u7ec4\u4ef6\u5f00\u59cb\uff0c\u9010\u6b65\u6269\u5c55\u5230\u6574\u4e2a\u7cfb\u7edf\u3002<\/li>\n\n\n\n\n
      2. \u5408\u7406\u914d\u7f6e<\/strong>\uff1a\u6839\u636e\u5b9e\u9645\u9700\u6c42\u914d\u7f6e\u5bfc\u51fa\u5668\u548c\u6536\u96c6\u5668\uff0c\u907f\u514d\u8fc7\u5ea6\u6536\u96c6\u6570\u636e\u3002<\/li>\n\n\n\n\n
      3. \u6301\u7eed\u76d1\u63a7<\/strong>\uff1a\u5b9a\u671f\u68c0\u67e5\u9065\u6d4b\u6570\u636e\uff0c\u53ca\u65f6\u53d1\u73b0\u548c\u89e3\u51b3\u95ee\u9898\u3002<\/li>\n\n\n\n\n
      4. \u5b89\u5168\u8003\u8651<\/strong>\uff1a\u786e\u4fdd\u9065\u6d4b\u6570\u636e\u7684\u4f20\u8f93\u548c\u5b58\u50a8\u5b89\u5168\uff0c\u907f\u514d\u654f\u611f\u4fe1\u606f\u6cc4\u9732\u3002<\/li>\n\n\n<\/ol>\n\n\n\n\n
        \u603b\u7ed3<\/h3>\n\n\n\n\n
        OpenTelemetry\u4e3a\u5f00\u53d1\u8005\u63d0\u4f9b\u4e86\u4e00\u5957\u5f3a\u5927\u7684\u5de5\u5177\u548c\u6807\u51c6\uff0c\u7528\u4e8e\u5b9e\u73b0\u5e94\u7528\u7a0b\u5e8f\u7684\u76d1\u63a7\u548c\u53ef\u89c2\u6d4b\u6027\u3002\u901a\u8fc7\u672c\u6587\u7684\u4ecb\u7ecd\uff0c\u5e0c\u671b\u4f60\u80fd\u521d\u6b65\u638c\u63e1OpenTelemetry\u7684\u5b89\u88c5\u3001\u914d\u7f6e\u548c\u4f7f\u7528\u65b9\u6cd5\uff0c\u5e76\u5728\u5b9e\u9645\u9879\u76ee\u4e2d\u5e94\u7528\u8fd9\u4e9b\u77e5\u8bc6\uff0c\u63d0\u5347\u5e94\u7528\u7a0b\u5e8f\u7684\u6027\u80fd\u548c\u7a33\u5b9a\u6027\u3002\u968f\u7740\u4e91\u539f\u751f\u6280\u672f\u7684\u53d1\u5c55\uff0cOpenTelemetry\u5c06\u6210\u4e3a\u5f00\u53d1\u8005\u4e0d\u53ef\u6216\u7f3a\u7684\u76d1\u63a7\u5229\u5668\u3002<\/p>\n\n\n]]>\t\t<\/p>\n","protected":false},"excerpt":{"rendered":"
        \t\t\t\t\t\t<\/p>\n","protected":false},"author":5,"featured_media":23093,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4],"tags":[],"class_list":["post-31763","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-discussion"],"_links":{"self":[{"href":"https:\/\/www.yunshan.net\/blog\/wp-json\/wp\/v2\/posts\/31763","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.yunshan.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.yunshan.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.yunshan.net\/blog\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/www.yunshan.net\/blog\/wp-json\/wp\/v2\/comments?post=31763"}],"version-history":[{"count":0,"href":"https:\/\/www.yunshan.net\/blog\/wp-json\/wp\/v2\/posts\/31763\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.yunshan.net\/blog\/wp-json\/wp\/v2\/media\/23093"}],"wp:attachment":[{"href":"https:\/\/www.yunshan.net\/blog\/wp-json\/wp\/v2\/media?parent=31763"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.yunshan.net\/blog\/wp-json\/wp\/v2\/categories?post=31763"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.yunshan.net\/blog\/wp-json\/wp\/v2\/tags?post=31763"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}