{"id":32060,"date":"2025-01-21T11:20:33","date_gmt":"2025-01-21T03:20:33","guid":{"rendered":"https:\/\/www.yunshan.net\/blog\/?p=24719"},"modified":"2025-01-21T11:20:33","modified_gmt":"2025-01-21T03:20:33","slug":"opentelemetry-%e5%a6%82%e4%bd%95%e9%9b%86%e6%88%90%e5%88%b0%e7%8e%b0%e6%9c%89%e7%9a%84%e5%ba%94%e7%94%a8%e7%a8%8b%e5%ba%8f%e4%b8%ad%ef%bc%9f","status":"publish","type":"post","link":"https:\/\/www.yunshan.net\/blog\/archives\/32060.html","title":{"rendered":"OpenTelemetry \u5982\u4f55\u96c6\u6210\u5230\u73b0\u6709\u7684\u5e94\u7528\u7a0b\u5e8f\u4e2d\uff1f"},"content":{"rendered":"

\t\t\t\t\n\n

\"OpenTelemetry<\/p>\n\n<\/p>\n\n\u5728\u73b0\u4ee3\u8f6f\u4ef6\u5f00\u53d1\u4e2d\uff0c\u53ef\u89c2\u6d4b\u6027\uff08Observability\uff09\u5df2\u7ecf\u6210\u4e3a\u6784\u5efa\u7a33\u5b9a\u3001\u9ad8\u6548\u7cfb\u7edf\u7684\u5173\u952e\u8981\u7d20\u3002\u968f\u7740\u5fae\u670d\u52a1\u67b6\u6784\u548c\u5206\u5e03\u5f0f\u7cfb\u7edf\u7684\u666e\u53ca\uff0c\u4f20\u7edf\u7684\u76d1\u63a7\u5de5\u5177\u5df2\u7ecf\u96be\u4ee5\u6ee1\u8db3\u590d\u6742\u7cfb\u7edf\u7684\u9700\u6c42\u3002OpenTelemetry\u4f5c\u4e3a\u4e00\u4e2a\u5f00\u6e90\u7684\u53ef\u89c2\u6d4b\u6027\u6846\u67b6\uff0c\u63d0\u4f9b\u4e86\u7edf\u4e00\u7684\u6807\u51c6\u5316\u65b9\u6848\uff0c\u5e2e\u52a9\u5f00\u53d1\u8005\u8f7b\u677e\u6536\u96c6\u3001\u5206\u6790\u548c\u53ef\u89c6\u5316\u5e94\u7528\u7a0b\u5e8f\u7684\u9065\u6d4b\u6570\u636e\u3002\u90a3\u4e48\uff0c\u5982\u4f55\u5c06OpenTelemetry\u96c6\u6210\u5230\u73b0\u6709\u7684\u5e94\u7528\u7a0b\u5e8f\u4e2d\uff0c\u4ee5\u63d0\u5347\u7cfb\u7edf\u7684\u53ef\u89c2\u6d4b\u6027\u5462\uff1f\u672c\u6587\u5c06\u4e3a\u60a8\u8be6\u7ec6\u89e3\u7b54\u3002\n\n 1. \u4ec0\u4e48\u662fOpenTelemetry\uff1f\n\nOpenTelemetry\u662f\u7531Cloud Native Computing Foundation\uff08CNCF\uff09\u5b75\u5316\u7684\u5f00\u6e90\u9879\u76ee\uff0c\u65e8\u5728\u4e3a\u5206\u5e03\u5f0f\u7cfb\u7edf\u63d0\u4f9b\u4e00\u5957\u6807\u51c6\u5316\u7684\u5de5\u5177\u548cAPI\uff0c\u7528\u4e8e\u6536\u96c6\u9065\u6d4b\u6570\u636e\uff08Telemetry Data\uff09\uff0c\u5305\u62ec\u6307\u6807\uff08Metrics\uff09\u3001\u65e5\u5fd7\uff08Logs\uff09\u548c\u8ffd\u8e2a\uff08Traces\uff09\u3002\u901a\u8fc7OpenTelemetry\uff0c\u5f00\u53d1\u8005\u53ef\u4ee5\u8f7b\u677e\u5730\u5c06\u8fd9\u4e9b\u6570\u636e\u5bfc\u51fa\u5230\u5404\u79cd\u540e\u7aef\u5206\u6790\u5de5\u5177\u4e2d\uff0c\u5982Prometheus\u3001Jaeger\u548cELK Stack\u7b49\u3002\n\n 2. \u4e3a\u4ec0\u4e48\u9700\u8981\u96c6\u6210OpenTelemetry\uff1f\n\n\u5728\u5206\u5e03\u5f0f\u7cfb\u7edf\u4e2d\uff0c\u4f20\u7edf\u7684\u76d1\u63a7\u65b9\u5f0f\u5f80\u5f80\u96be\u4ee5\u8986\u76d6\u6240\u6709\u7ec4\u4ef6\uff0c\u5c24\u5176\u662f\u5728\u5fae\u670d\u52a1\u67b6\u6784\u4e2d\uff0c\u670d\u52a1\u4e4b\u95f4\u7684\u8c03\u7528\u94fe\u8def\u590d\u6742\uff0c\u95ee\u9898\u5b9a\u4f4d\u56f0\u96be\u3002OpenTelemetry\u901a\u8fc7\u7edf\u4e00\u7684API\u548cSDK\uff0c\u5e2e\u52a9\u5f00\u53d1\u8005\u5b9e\u73b0\u4ee5\u4e0b\u76ee\u6807\uff1a\n\n– \u7aef\u5230\u7aef\u7684\u8ffd\u8e2a\uff1a\u8bb0\u5f55\u8bf7\u6c42\u5728\u591a\u4e2a\u670d\u52a1\u4e4b\u95f4\u7684\u6d41\u8f6c\u8def\u5f84\uff0c\u5feb\u901f\u5b9a\u4f4d\u6027\u80fd\u74f6\u9888\u3002\n– \u7edf\u4e00\u7684\u6307\u6807\u6536\u96c6\uff1a\u6807\u51c6\u5316\u6307\u6807\u91c7\u96c6\u65b9\u5f0f\uff0c\u51cf\u5c11\u91cd\u590d\u5de5\u4f5c\u3002\n– \u7075\u6d3b\u7684\u65e5\u5fd7\u7ba1\u7406\uff1a\u5c06\u65e5\u5fd7\u4e0e\u8ffd\u8e2a\u6570\u636e\u5173\u8054\uff0c\u63d0\u5347\u95ee\u9898\u6392\u67e5\u6548\u7387\u3002\n\n 3. \u96c6\u6210OpenTelemetry\u7684\u6b65\u9aa4\n\n\u5c06OpenTelemetry\u96c6\u6210\u5230\u73b0\u6709\u5e94\u7528\u7a0b\u5e8f\u4e2d\u5e76\u4e0d\u590d\u6742\uff0c\u4ee5\u4e0b\u662f\u5177\u4f53\u6b65\u9aa4\uff1a\n\n 3.1 \u9009\u62e9\u5408\u9002\u7684SDK\n\nOpenTelemetry\u652f\u6301\u591a\u79cd\u7f16\u7a0b\u8bed\u8a00\uff0c\u5305\u62ecJava\u3001Python\u3001Go\u3001Node.js\u7b49\u3002\u9996\u5148\uff0c\u6839\u636e\u5e94\u7528\u7a0b\u5e8f\u7684\u5f00\u53d1\u8bed\u8a00\u9009\u62e9\u5bf9\u5e94\u7684SDK\u3002\u4f8b\u5982\uff0c\u5bf9\u4e8eJava\u5e94\u7528\uff0c\u53ef\u4ee5\u4f7f\u7528`opentelemetry-java` SDK\u3002\n\n“`xml\n\n io.opentelemetry<\/groupId>\n opentelemetry-api<\/artifactId>\n 1.0.0<\/version>\n<\/dependency>\n\n io.opentelemetry<\/groupId>\n opentelemetry-sdk<\/artifactId>\n 1.0.0<\/version>\n<\/dependency>\n“`\n\n 3.2 \u914d\u7f6e\u81ea\u52a8\u6216\u624b\u52a8\u63d2\u6869\n\nOpenTelemetry\u652f\u6301\u81ea\u52a8\u63d2\u6869\uff08Auto-instrumentation\uff09\u548c\u624b\u52a8\u63d2\u6869\uff08Manual Instrumentation\uff09\u3002\u81ea\u52a8\u63d2\u6869\u901a\u8fc7\u4ee3\u7406\u6216\u5e93\u81ea\u52a8\u6355\u83b7\u5e94\u7528\u7a0b\u5e8f\u7684\u9065\u6d4b\u6570\u636e\uff0c\u9002\u5408\u5feb\u901f\u96c6\u6210\uff1b\u624b\u52a8\u63d2\u6869\u5219\u5141\u8bb8\u5f00\u53d1\u8005\u6839\u636e\u9700\u6c42\u81ea\u5b9a\u4e49\u6570\u636e\u91c7\u96c6\u903b\u8f91\u3002\n\n– \u81ea\u52a8\u63d2\u6869\uff1a\u5bf9\u4e8eJava\u5e94\u7528\uff0c\u53ef\u4ee5\u4f7f\u7528`opentelemetry-javaagent`\uff0c\u53ea\u9700\u5728\u542f\u52a8\u65f6\u6dfb\u52a0JVM\u53c2\u6570\u5373\u53ef\u3002\n\n“`bash\njava -javaagent:opentelemetry-javaagent.jar -jar your-application.jar\n“`\n\n– \u624b\u52a8\u63d2\u6869\uff1a\u901a\u8fc7OpenTelemetry API\u624b\u52a8\u6dfb\u52a0\u8ffd\u8e2a\u548c\u6307\u6807\u91c7\u96c6\u4ee3\u7801\u3002\n\n“`java\nTracer tracer = OpenTelemetry.getGlobalTracer(“my-app”);\nSpan span = tracer.spanBuilder(“my-operation”).startSpan();\ntry (Scope scope = span.makeCurrent()) {\n \/\/ \u4e1a\u52a1\u903b\u8f91\n} finally {\n span.end();\n}\n“`\n\n 3.3 \u914d\u7f6e\u5bfc\u51fa\u5668\n\nOpenTelemetry\u652f\u6301\u5c06\u9065\u6d4b\u6570\u636e\u5bfc\u51fa\u5230\u591a\u79cd\u540e\u7aef\u7cfb\u7edf\uff0c\u5982Jaeger\u3001Prometheus\u3001Zipkin\u7b49\u3002\u901a\u8fc7\u914d\u7f6e\u5bfc\u51fa\u5668\uff0c\u53ef\u4ee5\u5c06\u6570\u636e\u53d1\u9001\u5230\u6307\u5b9a\u7684\u5206\u6790\u5de5\u5177\u4e2d\u3002\n\n\u4f8b\u5982\uff0c\u5c06\u8ffd\u8e2a\u6570\u636e\u5bfc\u51fa\u5230Jaeger\uff1a\n\n“`java\nJaegerGrpcSpanExporter exporter = JaegerGrpcSpanExporter.builder()\n .setEndpoint(“http:\/\/localhost:14250”)\n .build();\n\nSdkTracerProvider tracerProvider = SdkTracerProvider.builder()\n .addSpanProcessor(BatchSpanProcessor.builder(exporter).build())\n .build();\n\nOpenTelemetrySdk.builder()\n .setTracerProvider(tracerProvider)\n .buildAndRegisterGlobal();\n“`\n\n 3.4 \u914d\u7f6e\u4e0a\u4e0b\u6587\u4f20\u64ad\n\n\u5728\u5206\u5e03\u5f0f\u7cfb\u7edf\u4e2d\uff0c\u8bf7\u6c42\u7684\u4e0a\u4e0b\u6587\u4fe1\u606f\uff08\u5982\u8ffd\u8e2aID\uff09\u9700\u8981\u5728\u670d\u52a1\u4e4b\u95f4\u4f20\u9012\u3002OpenTelemetry\u901a\u8fc7\u4e0a\u4e0b\u6587\u4f20\u64ad\uff08Context Propagation\uff09\u673a\u5236\u5b9e\u73b0\u8fd9\u4e00\u529f\u80fd\u3002\u5e38\u89c1\u7684\u4f20\u64ad\u65b9\u5f0f\u5305\u62ecHTTP\u5934\u3001gRPC\u5143\u6570\u636e\u7b49\u3002\n\n\u4f8b\u5982\uff0c\u5728HTTP\u8bf7\u6c42\u4e2d\u4f20\u64ad\u4e0a\u4e0b\u6587\uff1a\n\n“`java\nTextMapPropagator propagator = OpenTelemetry.getGlobalPropagators().getTextMapPropagator();\npropagator.inject(Context.current(), carrier, (c, k, v) -> c.setHeader(k, v));\n“`\n\n 3.5 \u914d\u7f6e\u8d44\u6e90\n\n\u8d44\u6e90\uff08Resource\uff09\u662f\u63cf\u8ff0\u5e94\u7528\u7a0b\u5e8f\u7684\u5143\u6570\u636e\uff0c\u5982\u670d\u52a1\u540d\u79f0\u3001\u7248\u672c\u53f7\u7b49\u3002\u901a\u8fc7\u914d\u7f6e\u8d44\u6e90\uff0c\u53ef\u4ee5\u4e3a\u9065\u6d4b\u6570\u636e\u6dfb\u52a0\u989d\u5916\u7684\u4e0a\u4e0b\u6587\u4fe1\u606f\u3002\n\n“`java\nResource resource = Resource.builder()\n .put(“service.name”, “my-service”)\n .put(“service.version”, “1.0.0”)\n .build();\n\nSdkTracerProvider tracerProvider = SdkTracerProvider.builder()\n .setResource(resource)\n .build();\n“`\n\n 4. \u96c6\u6210\u4e2d\u7684\u6ce8\u610f\u4e8b\u9879\n\n\u5728\u96c6\u6210OpenTelemetry\u65f6\uff0c\u9700\u8981\u6ce8\u610f\u4ee5\u4e0b\u51e0\u70b9\uff1a\n\n– \u6027\u80fd\u5f71\u54cd\uff1a\u867d\u7136OpenTelemetry\u7684\u8bbe\u8ba1\u76ee\u6807\u662f\u4f4e\u5f00\u9500\uff0c\u4f46\u5728\u9ad8\u5e76\u53d1\u573a\u666f\u4e0b\uff0c\u4ecd\u9700\u8bc4\u4f30\u5176\u5bf9\u6027\u80fd\u7684\u5f71\u54cd\u3002\n– \u6570\u636e\u91c7\u6837\uff1a\u4e3a\u4e86\u51cf\u5c11\u6570\u636e\u91cf\uff0c\u53ef\u4ee5\u914d\u7f6e\u91c7\u6837\u7b56\u7565\uff0c\u4f8b\u5982\u4ec5\u91c7\u96c6\u90e8\u5206\u8bf7\u6c42\u7684\u8ffd\u8e2a\u6570\u636e\u3002\n– \u5b89\u5168\u6027\uff1a\u786e\u4fdd\u9065\u6d4b\u6570\u636e\u7684\u4f20\u8f93\u548c\u5b58\u50a8\u7b26\u5408\u5b89\u5168\u8981\u6c42\uff0c\u907f\u514d\u654f\u611f\u4fe1\u606f\u6cc4\u9732\u3002\n\n 5. \u5b9e\u9645\u5e94\u7528\u6848\u4f8b\n\n\u4ee5\u4e00\u5bb6\u7535\u5546\u5e73\u53f0\u4e3a\u4f8b\uff0c\u8be5\u5e73\u53f0\u91c7\u7528\u5fae\u670d\u52a1\u67b6\u6784\uff0c\u5305\u542b\u8ba2\u5355\u670d\u52a1\u3001\u5e93\u5b58\u670d\u52a1\u548c\u652f\u4ed8\u670d\u52a1\u3002\u901a\u8fc7\u96c6\u6210OpenTelemetry\uff0c\u5e73\u53f0\u5b9e\u73b0\u4e86\u4ee5\u4e0b\u6539\u8fdb\uff1a\n\n– \u7aef\u5230\u7aef\u8ffd\u8e2a\uff1a\u7528\u6237\u4e0b\u5355\u65f6\uff0c\u7cfb\u7edf\u8bb0\u5f55\u4e86\u4ece\u8ba2\u5355\u521b\u5efa\u5230\u652f\u4ed8\u5b8c\u6210\u7684\u5b8c\u6574\u94fe\u8def\uff0c\u5e2e\u52a9\u5f00\u53d1\u56e2\u961f\u5feb\u901f\u5b9a\u4f4d\u8d85\u65f6\u95ee\u9898\u3002\n– \u7edf\u4e00\u6307\u6807\uff1a\u6240\u6709\u670d\u52a1\u7684\u6027\u80fd\u6307\u6807\uff08\u5982\u54cd\u5e94\u65f6\u95f4\u3001\u9519\u8bef\u7387\uff09\u88ab\u7edf\u4e00\u6536\u96c6\u5e76\u53ef\u89c6\u5316\uff0c\u4fbf\u4e8e\u8fd0\u7ef4\u56e2\u961f\u76d1\u63a7\u7cfb\u7edf\u5065\u5eb7\u72b6\u6001\u3002\n– \u65e5\u5fd7\u5173\u8054\uff1a\u901a\u8fc7\u5c06\u65e5\u5fd7\u4e0e\u8ffd\u8e2aID\u5173\u8054\uff0c\u5f00\u53d1\u8005\u5728\u6392\u67e5\u95ee\u9898\u65f6\u53ef\u4ee5\u5feb\u901f\u627e\u5230\u76f8\u5173\u65e5\u5fd7\uff0c\u63d0\u5347\u6548\u7387\u3002\n\n 6. \u603b\u7ed3\n\n\u901a\u8fc7\u4ee5\u4e0a\u6b65\u9aa4\uff0c\u60a8\u53ef\u4ee5\u5c06OpenTelemetry\u65e0\u7f1d\u96c6\u6210\u5230\u73b0\u6709\u7684\u5e94\u7528\u7a0b\u5e8f\u4e2d\uff0c\u4ece\u800c\u63d0\u5347\u7cfb\u7edf\u7684\u53ef\u89c2\u6d4b\u6027\u3002\u65e0\u8bba\u662f\u81ea\u52a8\u63d2\u6869\u8fd8\u662f\u624b\u52a8\u63d2\u6869\uff0cOpenTelemetry\u90fd\u63d0\u4f9b\u4e86\u7075\u6d3b\u7684\u65b9\u6848\uff0c\u6ee1\u8db3\u4e0d\u540c\u573a\u666f\u7684\u9700\u6c42\u3002\u968f\u7740\u53ef\u89c2\u6d4b\u6027\u5728\u8f6f\u4ef6\u5f00\u53d1\u4e2d\u7684\u91cd\u8981\u6027\u65e5\u76ca\u51f8\u663e\uff0cOpenTelemetry\u65e0\u7591\u5c06\u6210\u4e3a\u5f00\u53d1\u8005\u4e0d\u53ef\u6216\u7f3a\u7684\u5de5\u5177\u4e4b\u4e00\u3002 ]]>\t\t<\/p>\n","protected":false},"excerpt":{"rendered":"

\t\t\t\t\t\t<\/p>\n","protected":false},"author":5,"featured_media":24720,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4],"tags":[],"class_list":["post-32060","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\/32060","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=32060"}],"version-history":[{"count":0,"href":"https:\/\/www.yunshan.net\/blog\/wp-json\/wp\/v2\/posts\/32060\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.yunshan.net\/blog\/wp-json\/wp\/v2\/media\/24720"}],"wp:attachment":[{"href":"https:\/\/www.yunshan.net\/blog\/wp-json\/wp\/v2\/media?parent=32060"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.yunshan.net\/blog\/wp-json\/wp\/v2\/categories?post=32060"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.yunshan.net\/blog\/wp-json\/wp\/v2\/tags?post=32060"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}