{"id":99,"date":"2026-07-10T04:30:11","date_gmt":"2026-07-10T04:30:11","guid":{"rendered":"https:\/\/blog.top-api.cc\/?p=99"},"modified":"2026-07-10T04:30:11","modified_gmt":"2026-07-10T04:30:11","slug":"ai-gateway-opentelemetry-tracing-guide-20260710","status":"publish","type":"post","link":"https:\/\/blog.top-api.cc\/?p=99","title":{"rendered":"AI \u7f51\u5173\u63a5\u5165 OpenTelemetry \u8981\u8bb0\u4ec0\u4e48\uff1a\u628a\u6a21\u578b\u8c03\u7528\u53d8\u6210\u53ef\u8ffd\u8e2a\u7684\u94fe\u8def"},"content":{"rendered":"

AI \u5e94\u7528\u7684\u6162\u8bf7\u6c42\u901a\u5e38\u4e0d\u662f\u5355\u70b9\u6545\u969c\uff1a\u7528\u6237\u8bf7\u6c42\u5148\u7ecf\u8fc7 Web \u670d\u52a1\uff0c\u518d\u8fdb\u5165 Agent\u3001\u5de5\u5177\u3001\u961f\u5217\u548c\u6a21\u578b\u7f51\u5173\uff0c\u6700\u540e\u624d\u5230\u4f9b\u5e94\u5546\u3002\u5982\u679c\u6bcf\u4e00\u5c42\u53ea\u5199\u4e00\u884c\u201c\u8c03\u7528\u5931\u8d25\u201d\uff0c\u6392\u67e5\u65f6\u5c31\u4e0d\u77e5\u9053\u5ef6\u8fdf\u53d1\u751f\u5728\u54ea\u91cc\uff0c\u4e5f\u65e0\u6cd5\u5224\u65ad\u662f\u8def\u7531\u7b56\u7565\u3001\u7f51\u7edc\u8fd8\u662f\u6a21\u578b\u672c\u8eab\u9020\u6210\u7684\u3002<\/p>\n

\u4e00\u6761\u6a21\u578b\u8c03\u7528\u81f3\u5c11\u8981\u6709\u4e09\u5c42\u4fe1\u606f<\/h2>\n

\u7b2c\u4e00\u5c42\u662f\u94fe\u8def\u5173\u8054\u4fe1\u606f\uff1atrace_id\u3001span_id\u3001\u7236\u7ea7 span\u3001\u79df\u6237\u6216\u9879\u76ee\u7684\u5185\u90e8\u6807\u8bc6\uff0c\u4ee5\u53ca\u8bf7\u6c42\u5f00\u59cb\u548c\u7ed3\u675f\u65f6\u95f4\u3002\u7b2c\u4e8c\u5c42\u662f\u6a21\u578b\u4fe1\u606f\uff1a\u4f9b\u5e94\u5546\u3001\u6a21\u578b\u540d\u3001\u6a21\u578b\u7248\u672c\u6216\u522b\u540d\u3001\u8def\u7531\u51b3\u7b56\u548c\u662f\u5426\u53d1\u751f\u56de\u9000\u3002\u7b2c\u4e09\u5c42\u662f\u7ed3\u679c\u4fe1\u606f\uff1a\u8f93\u5165\u548c\u8f93\u51fa token\u3001\u9996\u5b57\u8282\u65f6\u95f4\u3001\u603b\u5ef6\u8fdf\u3001\u72b6\u6001\u3001\u7ed3\u675f\u539f\u56e0\u3001\u91cd\u8bd5\u6b21\u6570\u548c\u9519\u8bef\u5206\u7c7b\u3002<\/p>\n

\u8fd9\u4e9b\u5b57\u6bb5\u5e94\u5c3d\u91cf\u4f7f\u7528\u7a33\u5b9a\u7684\u679a\u4e3e\u548c\u5185\u90e8 ID\u3002\u4e0d\u8981\u628a\u5b8c\u6574\u63d0\u793a\u8bcd\u3001\u6587\u4ef6\u5185\u5bb9\u3001API Key \u6216\u7528\u6237\u90ae\u7bb1\u76f4\u63a5\u5f53\u6210 span \u5c5e\u6027\u3002\u9700\u8981\u6392\u969c\u65f6\uff0c\u53ef\u4ee5\u4fdd\u5b58\u7ecf\u8fc7\u8131\u654f\u7684\u6458\u8981\u3001\u7248\u672c\u53f7\u6216\u5185\u5bb9\u54c8\u5e0c\uff0c\u518d\u901a\u8fc7\u53d7\u63a7\u7684\u65e5\u5fd7\u7cfb\u7edf\u67e5\u8be2\u539f\u59cb\u8bc1\u636e\u3002<\/p>\n

\u4e0d\u8981\u628a token \u5f53\u6210\u552f\u4e00\u6210\u672c\u6307\u6807<\/h2>\n

token \u6570\u91cf\u662f\u91cd\u8981\u7684\u8d44\u6e90\u6307\u6807\uff0c\u4f46\u5b83\u4e0d\u80fd\u89e3\u91ca\u6240\u6709\u6210\u672c\u3002\u56fe\u50cf\u3001\u97f3\u9891\u3001\u5de5\u5177\u8c03\u7528\u3001\u7f13\u5b58\u547d\u4e2d\u548c\u4f9b\u5e94\u5546\u8ba1\u8d39\u89c4\u5219\u53ef\u80fd\u4f7f\u7528\u4e0d\u540c\u5355\u4f4d\u3002\u7f51\u5173\u53ef\u4ee5\u540c\u65f6\u8bb0\u5f55 usage \u539f\u503c\u3001\u5185\u90e8\u6210\u672c\u4f30\u7b97\u3001\u8ba1\u8d39\u7248\u672c\u548c\u62a5\u4ef7\u8868\u7248\u672c\uff0c\u5e76\u5728\u8d26\u5355\u5bf9\u8d26\u65f6\u6807\u8bb0\u201c\u4f30\u7b97\u201d\u548c\u201c\u5df2\u786e\u8ba4\u201d\u4e24\u79cd\u72b6\u6001\u3002<\/p>\n

\u5ef6\u8fdf\u4e5f\u8981\u62c6\u5f00\uff1a\u6392\u961f\u65f6\u95f4\u3001\u9274\u6743\u65f6\u95f4\u3001\u4e0a\u6e38\u8fde\u63a5\u65f6\u95f4\u3001\u9996\u5b57\u8282\u65f6\u95f4\u3001\u751f\u6210\u65f6\u95f4\u548c\u540e\u5904\u7406\u65f6\u95f4\u3002\u5bf9\u4e8e\u6d41\u5f0f\u8bf7\u6c42\uff0c\u5e73\u5747\u5ef6\u8fdf\u5e38\u5e38\u63a9\u76d6\u957f\u5c3e\uff0c\u81f3\u5c11\u8981\u770b P50\u3001P95 \u548c P99\u3002\u5bf9\u5931\u8d25\u8bf7\u6c42\uff0c\u8bb0\u5f55\u6700\u540e\u4e00\u4e2a\u534f\u8bae\u4e8b\u4ef6\u548c\u662f\u5426\u5df2\u7ecf\u4ea7\u751f token\uff0c\u6bd4\u5355\u4e2a 500 \u72b6\u6001\u7801\u66f4\u6709\u7528\u3002<\/p>\n

\u8ba9\u7f51\u5173\u6210\u4e3a\u7edf\u4e00\u89c2\u6d4b\u8fb9\u754c<\/h2>\n

\u5982\u679c\u6bcf\u4e2a\u5e94\u7528\u81ea\u5df1\u63a5\u5165\u4e0d\u540c\u5382\u5546 SDK\uff0c\u5b57\u6bb5\u5f88\u5feb\u4f1a\u5931\u63a7\u3002\u628a top-api.cc<\/a> \u8fd9\u7c7b\u4e2d\u8f6c\u5165\u53e3\u4f5c\u4e3a\u7edf\u4e00\u8fb9\u754c\uff0c\u53ef\u4ee5\u5728\u4e0d\u6539\u52a8\u4e1a\u52a1\u4ee3\u7801\u7684\u60c5\u51b5\u4e0b\u8865\u5145\u8def\u7531\u3001\u6a21\u578b\u3001\u6210\u672c\u548c\u91cd\u8bd5\u5b57\u6bb5\u3002\u5e94\u7528\u53ea\u9700\u8981\u4f20\u9012\u4e1a\u52a1 trace \u548c\u9879\u76ee\u6807\u8bc6\uff0c\u7f51\u5173\u8d1f\u8d23\u628a\u4e0a\u6e38\u54cd\u5e94\u6620\u5c04\u5230\u7edf\u4e00\u7684\u5185\u90e8\u4e8b\u4ef6\u3002<\/p>\n

\u4f46\u7edf\u4e00\u5165\u53e3\u4e0d\u7b49\u4e8e\u65e0\u9650\u91c7\u96c6\u3002\u5efa\u8bae\u6309\u79df\u6237\u548c\u73af\u5883\u8bbe\u7f6e\u91c7\u6837\u7387\uff0c\u5f00\u53d1\u73af\u5883\u53ef\u4fdd\u5b58\u66f4\u591a\u8c03\u8bd5\u4fe1\u606f\uff0c\u751f\u4ea7\u73af\u5883\u53ea\u4fdd\u7559\u5fc5\u8981\u6458\u8981\u3002\u5bf9\u9ad8\u98ce\u9669\u5de5\u5177\u8c03\u7528\uff0c\u589e\u52a0\u5ba1\u6279\u7ed3\u679c\u3001\u6267\u884c\u72b6\u6001\u548c\u56de\u6eda\u6807\u8bc6\uff1b\u5bf9\u666e\u901a\u6587\u672c\u8bf7\u6c42\uff0c\u5219\u4e0d\u5fc5\u4fdd\u5b58\u5b8c\u6574\u5185\u5bb9\u3002<\/p>\n

\u843d\u5730\u987a\u5e8f<\/h2>\n
    \n
  1. \u5148\u7edf\u4e00 trace \u4f20\u64ad\u548c\u8bf7\u6c42\u72b6\u6001\uff1b<\/li>\n
  2. \u518d\u589e\u52a0\u6a21\u578b\u3001\u8def\u7531\u3001\u5ef6\u8fdf\u548c token \u5b57\u6bb5\uff1b<\/li>\n
  3. \u901a\u8fc7\u9519\u8bef\u5206\u7c7b\u533a\u5206\u9650\u6d41\u3001\u8d85\u65f6\u3001\u62d2\u7b54\u548c\u534f\u8bae\u9519\u8bef\uff1b<\/li>\n
  4. \u628a\u9065\u6d4b\u6570\u636e\u4e0e\u8d26\u5355\u3001\u53d1\u5e03\u7248\u672c\u548c\u56de\u653e\u6837\u672c\u5173\u8054\uff1b<\/li>\n
  5. \u6700\u540e\u518d\u51b3\u5b9a\u54ea\u4e9b\u8131\u654f\u7247\u6bb5\u503c\u5f97\u4fdd\u7559\u3002<\/li>\n<\/ol>\n

    OpenTelemetry \u7684\u4ef7\u503c\u5728\u4e8e\u53ef\u79fb\u690d\u7684\u94fe\u8def\u57fa\u7840\uff0c\u800c\u4e0d\u662f\u66ff\u4ee3\u6240\u6709 AI \u4e13\u7528\u6307\u6807\u3002\u63a5\u5165\u524d\u5148\u660e\u786e\u8c01\u80fd\u770b\u539f\u59cb\u5185\u5bb9\u3001\u4fdd\u7559\u591a\u4e45\u3001\u5982\u4f55\u5220\u9664\uff0c\u907f\u514d\u4e3a\u4e86\u201c\u53ef\u89c2\u6d4b\u201d\u628a\u654f\u611f\u6570\u636e\u590d\u5236\u5230\u66f4\u591a\u7cfb\u7edf\u3002<\/p>\n

    \u53c2\u8003\u8d44\u6599\uff1aOpenTelemetry Semantic Conventions \u7684 GenAI \u65b9\u5411\u3001LiteLLM Proxy \u4e0e Portkey Gateway \u7684\u89c2\u6d4b\u80fd\u529b\u8bf4\u660e\u3002\u6807\u51c6\u5b57\u6bb5\u4ecd\u5728\u6f14\u8fdb\uff0c\u751f\u4ea7\u73af\u5883\u5e94\u9501\u5b9a\u81ea\u5df1\u7684\u5b57\u6bb5\u7248\u672c\u3002<\/p>\n

    \u5982\u679c\u4f60\u7684\u5e94\u7528\u5df2\u7ecf\u6709\u591a\u5bb6\u6a21\u578b\u4f9b\u5e94\u5546\uff0c\u5148\u628a\u8bf7\u6c42\u7edf\u4e00\u7ecf\u8fc7 top-api.cc<\/a>\uff0c\u518d\u5728\u7f51\u5173\u8fb9\u754c\u4e0a\u5efa\u7acb\u4e00\u5957\u53ef\u8fc1\u79fb\u7684 trace \u548c\u6210\u672c\u5b57\u6bb5\uff0c\u901a\u5e38\u6bd4\u9010\u4e2a\u6539 SDK \u66f4\u5bb9\u6613\u63a7\u5236\u8303\u56f4\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"

    AI \u8c03\u7528\u7684\u95ee\u9898\u5e38\u5e38\u8de8\u8d8a\u5e94\u7528\u3001\u7f51\u5173\u3001\u961f\u5217\u548c\u4f9b\u5e94\u5546\u3002\u63a5\u5165 OpenTelemetry \u65f6\uff0c\u5e94\u4f18\u5148\u7edf\u4e00 trace\u3001\u6a21\u578b\u3001\u8def\u7531\u3001token\u3001\u5ef6\u8fdf\u548c\u9519\u8bef\u5b57\u6bb5\uff0c\u540c\u65f6\u907f\u514d\u628a\u5b8c\u6574\u63d0\u793a\u8bcd\u548c\u7528\u6237\u6570\u636e\u76f4\u63a5\u5199\u8fdb\u9065\u6d4b\u7cfb\u7edf\u3002<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-99","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/blog.top-api.cc\/index.php?rest_route=\/wp\/v2\/posts\/99","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.top-api.cc\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.top-api.cc\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.top-api.cc\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.top-api.cc\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=99"}],"version-history":[{"count":0,"href":"https:\/\/blog.top-api.cc\/index.php?rest_route=\/wp\/v2\/posts\/99\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.top-api.cc\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=99"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.top-api.cc\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=99"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.top-api.cc\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=99"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}