Create & Init Project...

app/service/main/dapper-query/api/v1/BUILD

@@ -0,0 +1,47 @@
+load(
+    "@io_bazel_rules_go//proto:def.bzl",
+    "go_proto_library",
+)
+
+package(default_visibility = ["//visibility:public"])
+
+load(
+    "@io_bazel_rules_go//go:def.bzl",
+    "go_library",
+)
+
+filegroup(
+    name = "package-srcs",
+    srcs = glob(["**"]),
+    tags = ["automanaged"],
+    visibility = ["//visibility:private"],
+)
+
+filegroup(
+    name = "all-srcs",
+    srcs = [":package-srcs"],
+    tags = ["automanaged"],
+    visibility = ["//visibility:public"],
+)
+
+go_library(
+    name = "go_default_library",
+    srcs = [
+        "api.pb.bm.go",
+        "api.pb.go",
+        "marshal.go",
+    ],
+    importpath = "go-common/app/service/main/dapper-query/api/v1",
+    tags = ["manual"],
+    visibility = ["//visibility:public"],
+    deps = [
+        "//app/tool/protoc-gen-bm/jsonpb:go_default_library",
+        "//library/net/http/blademaster:go_default_library",
+        "@com_github_gogo_protobuf//gogoproto:go_default_library",
+        "@com_github_gogo_protobuf//proto:go_default_library",
+        "@com_github_golang_protobuf//jsonpb:go_default_library",
+        "@go_googleapis//google/api:annotations_go_proto",
+        "@org_golang_google_grpc//:go_default_library",
+        "@org_golang_x_net//context:go_default_library",
+    ],
+)

app/service/main/dapper-query/api/v1/README.md

@@ -0,0 +1,446 @@
+api/v1/api.proto
+================
+**Version:** version not set
+
+### /x/internal/dapper/clt-status
+---
+##### ***GET***
+**Summary:** CltStatus 获取 collector 信息
+
+**Responses**
+
+| Code | Description | Schema |
+| ---- | ----------- | ------ |
+| 200 | A successful response. | [v1CltStatusReply](#v1cltstatusreply) |
+
+### /x/internal/dapper/depends-rank
+---
+##### ***GET***
+**Summary:** DependsRank 查询某一个 service_name:operation_name 下所有依赖组件排名
+
+**Parameters**
+
+| Name | Located in | Description | Required | Schema |
+| ---- | ---------- | ----------- | -------- | ---- |
+| service_name | query |  | No | string |
+| start | query |  | No | string (int64) |
+| end | query |  | No | string (int64) |
+| rank_type | query | 排序类型 max_duration 最大耗时, min_duration 最小耗时, avg_duration 平均耗时, errors 错误数. | No | string |
+
+**Responses**
+
+| Code | Description | Schema |
+| ---- | ----------- | ------ |
+| 200 | A successful response. | [v1DependsRankReply](#v1dependsrankreply) |
+
+### /x/internal/dapper/depends-topology
+---
+##### ***GET***
+**Summary:** DependsTopology 获取依赖拓扑图
+
+**Responses**
+
+| Code | Description | Schema |
+| ---- | ----------- | ------ |
+| 200 | A successful response. | [v1DependsTopologyReply](#v1dependstopologyreply) |
+
+### /x/internal/dapper/list-span
+---
+##### ***GET***
+**Summary:** ListSpan 列出一个 service_name 某一 operation_name 所有采样到 Span
+
+**Parameters**
+
+| Name | Located in | Description | Required | Schema |
+| ---- | ---------- | ----------- | -------- | ---- |
+| service_name | query |  | No | string |
+| operation_name | query |  | No | string |
+| start | query |  | No | string (int64) |
+| end | query |  | No | string (int64) |
+| order | query | 目前支持的 order  time:desc time:asc 按时间排序 duration:desc duration:asc 按耗时排序. | No | string |
+| only_error | query | 只显示 error 的 span. | No | boolean (boolean) |
+| offset | query |  | No | integer |
+| limit | query |  | No | integer |
+
+**Responses**
+
+| Code | Description | Schema |
+| ---- | ----------- | ------ |
+| 200 | A successful response. | [v1ListSpanReply](#v1listspanreply) |
+
+### /x/internal/dapper/operation-names
+---
+##### ***GET***
+**Summary:** ListOperationName 列出某一 service  下所有 operation_name 仅 span.kind 为 server 的 operation_name
+
+**Parameters**
+
+| Name | Located in | Description | Required | Schema |
+| ---- | ---------- | ----------- | -------- | ---- |
+| service_name | query |  | No | string |
+
+**Responses**
+
+| Code | Description | Schema |
+| ---- | ----------- | ------ |
+| 200 | A successful response. | [v1ListOperationNameReply](#v1listoperationnamereply) |
+
+### /x/internal/dapper/operation-names-rank
+---
+##### ***GET***
+**Summary:** OperationNameRank 查询 OperationName 排名列表
+
+**Parameters**
+
+| Name | Located in | Description | Required | Schema |
+| ---- | ---------- | ----------- | -------- | ---- |
+| service_name | query |  | No | string |
+| start | query |  | No | string (int64) |
+| end | query |  | No | string (int64) |
+| rank_type | query | 排序类型 max_duration 最大耗时, min_duration 最小耗时, avg_duration 平均耗时, errors 错误数. | No | string |
+
+**Responses**
+
+| Code | Description | Schema |
+| ---- | ----------- | ------ |
+| 200 | A successful response. | [v1OperationNameRankReply](#v1operationnamerankreply) |
+
+### /x/internal/dapper/ops-log
+---
+##### ***GET***
+**Summary:** OpsLog 获取 通过 trace-id 获取 opslog 记录
+如果请求的 trace-id 没有被记录到, 则需要提供 service_name operation_name 和 timestamp 进行模糊查询
+
+**Parameters**
+
+| Name | Located in | Description | Required | Schema |
+| ---- | ---------- | ----------- | -------- | ---- |
+| trace_id | query |  | No | string |
+| span_id | query |  | No | string |
+| trace_field | query |  | No | string |
+| service_name | query |  | No | string |
+| operation_name | query |  | No | string |
+| start | query | 开始时间. | No | string (int64) |
+| end | query | 结束时间. | No | string (int64) |
+
+**Responses**
+
+| Code | Description | Schema |
+| ---- | ----------- | ------ |
+| 200 | A successful response. | [v1OpsLogReply](#v1opslogreply) |
+
+### /x/internal/dapper/raw-trace
+---
+##### ***GET***
+**Summary:** RawTrace 原始 Trace 数据
+
+**Parameters**
+
+| Name | Located in | Description | Required | Schema |
+| ---- | ---------- | ----------- | -------- | ---- |
+| trace_id | query |  | No | string |
+
+**Responses**
+
+| Code | Description | Schema |
+| ---- | ----------- | ------ |
+| 200 | A successful response. | [v1RawTraceReply](#v1rawtracereply) |
+
+### /x/internal/dapper/sample-point
+---
+##### ***GET***
+**Summary:** SamplePoint 获取采样点数据
+
+**Parameters**
+
+| Name | Located in | Description | Required | Schema |
+| ---- | ---------- | ----------- | -------- | ---- |
+| service_name | query |  | No | string |
+| operation_name | query |  | No | string |
+| only_error | query | only_error 在 errors 那个图可以指定为 true. | No | boolean (boolean) |
+| interval | query | interval 使用 span-series 返回的 interval 即可. | No | string (int64) |
+| time | query | time 使用 time-series 返回的时间即可，相同格式型如 2006-01-02T15:04:05. | No | string |
+
+**Responses**
+
+| Code | Description | Schema |
+| ---- | ----------- | ------ |
+| 200 | A successful response. | [v1SamplePointReply](#v1samplepointreply) |
+
+### /x/internal/dapper/service-depend
+---
+##### ***GET***
+**Summary:** ServiceDepend 查询服务的直接依赖
+TODO: 通过最近收集的到3 个 span 实时计算的，在当前查询的服务出现不正常的时候，查询结果可能不准确
+
+**Parameters**
+
+| Name | Located in | Description | Required | Schema |
+| ---- | ---------- | ----------- | -------- | ---- |
+| service_name | query | service_name 不解释!. | No | string |
+| operation_name | query | operation_name 当 operation_name 为空时查询所有 operation_name 然后 merge 结果. | No | string |
+
+**Responses**
+
+| Code | Description | Schema |
+| ---- | ----------- | ------ |
+| 200 | A successful response. | [v1ServiceDependReply](#v1servicedependreply) |
+
+### /x/internal/dapper/service-names
+---
+##### ***GET***
+**Summary:** ListServiceName 列出所有 service
+
+**Responses**
+
+| Code | Description | Schema |
+| ---- | ----------- | ------ |
+| 200 | A successful response. | [v1ListServiceNameReply](#v1listservicenamereply) |
+
+### /x/internal/dapper/span-series
+---
+##### ***GET***
+**Summary:** SpanSeries 获取 span 的时间序列数据
+
+**Parameters**
+
+| Name | Located in | Description | Required | Schema |
+| ---- | ---------- | ----------- | -------- | ---- |
+| service_name | query |  | No | string |
+| operation_name | query |  | No | string |
+| start | query |  | No | string (int64) |
+| end | query |  | No | string (int64) |
+| fields | query | 可选的 fields 有 max_duration, min_duration, avg_duration, errors 其中除 errors 返回的是一段时间内的总数 其他返回的都是平均数 fields 是个数组可以通过 fields=max_duration,min_duration,avg_duration 逗号分隔. | No | string |
+
+**Responses**
+
+| Code | Description | Schema |
+| ---- | ----------- | ------ |
+| 200 | A successful response. | [v1SpanSeriesReply](#v1spanseriesreply) |
+
+### /x/internal/dapper/trace
+---
+##### ***GET***
+**Summary:** Trace 查询一个 Trace
+
+**Parameters**
+
+| Name | Located in | Description | Required | Schema |
+| ---- | ---------- | ----------- | -------- | ---- |
+| trace_id | query |  | No | string |
+| span_id | query |  | No | string |
+
+**Responses**
+
+| Code | Description | Schema |
+| ---- | ----------- | ------ |
+| 200 | A successful response. | [v1TraceReply](#v1tracereply) |
+
+### Models
+---
+
+### v1Client  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| addr | string |  | No |
+| err_count | string (int64) |  | No |
+| rate | string (int64) |  | No |
+| up_time | string (int64) |  | No |
+
+### v1CltNode  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| node | string |  | No |
+| queue_len | string (int64) |  | No |
+| clients | [ [v1Client](#v1client) ] |  | No |
+
+### v1CltStatusReply  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| nodes | [ [v1CltNode](#v1cltnode) ] |  | No |
+
+### v1DependsRankReply  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| rank_type | string |  | No |
+| items | [ [v1RankItem](#v1rankitem) ] |  | No |
+
+### v1DependsTopologyItem  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| service_name | string |  | No |
+| depend_on | string |  | No |
+
+### v1DependsTopologyReply  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| items | [ [v1DependsTopologyItem](#v1dependstopologyitem) ] |  | No |
+
+### v1Field  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| key | string |  | No |
+| value | string |  | No |
+
+### v1ListOperationNameReply  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| operation_names | [ string ] |  | No |
+
+### v1ListServiceNameReply  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| service_names | [ string ] |  | No |
+
+### v1ListSpanReply  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| items | [ [v1SpanListItem](#v1spanlistitem) ] |  | No |
+
+### v1Log  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| timestamp | string (int64) |  | No |
+| fields | [ [v1Field](#v1field) ] |  | No |
+
+### v1OperationNameRankReply  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| rank_type | string |  | No |
+| items | [ [v1RankItem](#v1rankitem) ] |  | No |
+
+### v1OpsLogRecord  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| time | string |  | No |
+| fields | object |  | No |
+| level | string |  | No |
+| message | string |  | No |
+
+### v1OpsLogReply  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| records | [ [v1OpsLogRecord](#v1opslogrecord) ] |  | No |
+
+### v1RankItem  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| service_name | string |  | No |
+| operation_name | string |  | No |
+| value | double |  | No |
+
+### v1RawTraceReply  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| items | [ [v1Span](#v1span) ] |  | No |
+
+### v1SamplePointItem  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| trace_id | string |  | No |
+| span_id | string |  | No |
+| duration | string (int64) |  | No |
+| is_error | boolean (boolean) |  | No |
+
+### v1SamplePointReply  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| items | [ [v1SamplePointItem](#v1samplepointitem) ] |  | No |
+
+### v1SeriesItem  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| field | string |  | No |
+| values | [ string (int64) ] |  | No |
+
+### v1ServiceDependItem  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| service_name | string |  | No |
+| component | string |  | No |
+| operation_names | [ string ] |  | No |
+
+### v1ServiceDependReply  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| items | [ [v1ServiceDependItem](#v1servicedependitem) ] |  | No |
+
+### v1Span  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| service_name | string |  | No |
+| operation_name | string |  | No |
+| trace_id | string |  | No |
+| span_id | string |  | No |
+| parent_id | string |  | No |
+| start_time | string (int64) |  | No |
+| duration | string (int64) |  | No |
+| tags | object |  | No |
+| logs | [ [v1Log](#v1log) ] |  | No |
+| level | integer |  | No |
+| childs | [ [v1Span](#v1span) ] |  | No |
+
+### v1SpanListItem  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| trace_id | string |  | No |
+| span_id | string |  | No |
+| parent_id | string |  | No |
+| service_name | string |  | No |
+| operation_name | string |  | No |
+| start_time | string |  | No |
+| duration | string |  | No |
+| tags | object |  | No |
+| is_error | boolean (boolean) |  | No |
+| container_ip | string |  | No |
+| region_zone | string |  | No |
+| mark | string |  | No |
+
+### v1SpanSeriesReply  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| interval | string (int64) |  | No |
+| times | [ string ] |  | No |
+| items | [ [v1SeriesItem](#v1seriesitem) ] |  | No |
+
+### v1TagValue  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| string_value | string |  | No |
+| int64_value | string (int64) |  | No |
+| bool_value | boolean (boolean) |  | No |
+| float_value | float |  | No |
+
+### v1TraceReply  
+
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| service_count | integer |  | No |
+| span_count | integer |  | No |
+| max_level | integer |  | No |
+| root | [v1Span](#v1span) |  | No |

app/service/main/dapper-query/api/v1/api.pb.bm.go

@@ -0,0 +1,260 @@
+// Package v1 Code generated by go-common/app/tool/protoc-gen-bm. DO NOT EDIT.
+package v1
+
+import (
+	"bytes"
+	"context"
+	"encoding/json"
+
+	"go-common/app/tool/protoc-gen-bm/jsonpb"
+
+	bm "go-common/library/net/http/blademaster"
+)
+
+// BMDapperQueryServer interface as same as gGRPC server define
+type BMDapperQueryServer interface {
+	ListServiceName(context.Context, *ListServiceNameReq) (*ListServiceNameReply, error)
+	ListOperationName(context.Context, *ListOperationNameReq) (*ListOperationNameReply, error)
+	ListSpan(context.Context, *ListSpanReq) (*ListSpanReply, error)
+	Trace(context.Context, *TraceReq) (*TraceReply, error)
+	RawTrace(context.Context, *RawTraceReq) (*RawTraceReply, error)
+	OperationNameRank(context.Context, *OperationNameRankReq) (*OperationNameRankReply, error)
+	DependsRank(context.Context, *DependsRankReq) (*DependsRankReply, error)
+	SpanSeries(context.Context, *SpanSeriesReq) (*SpanSeriesReply, error)
+	SamplePoint(context.Context, *SamplePointReq) (*SamplePointReply, error)
+	CltStatus(context.Context, *CltStatusReq) (*CltStatusReply, error)
+	DependsTopology(context.Context, *DependsTopologyReq) (*DependsTopologyReply, error)
+	OpsLog(context.Context, *OpsLogReq) (*OpsLogReply, error)
+	ServiceDepend(context.Context, *ServiceDependReq) (*ServiceDependReply, error)
+}
+
+// _BMServerDapperQueryserver
+type _BMServerDapperQuery struct {
+	BMDapperQueryServer
+}
+
+func (b *_BMServerDapperQuery) bmDapperQueryListServiceNameHandler(c *bm.Context) {
+	req := new(ListServiceNameReq)
+	if err := c.Bind(req); err != nil {
+		return
+	}
+	reply, err := b.ListServiceName(c.Context, req)
+	if err != nil {
+		c.JSON(nil, err)
+		return
+	}
+	body := &bytes.Buffer{}
+	marshaler := jsonpb.Marshaler{EmitDefaults: true, OrigName: true}
+	err = marshaler.Marshal(body, reply)
+	c.JSON(json.RawMessage(body.Bytes()), err)
+}
+
+func (b *_BMServerDapperQuery) bmDapperQueryListOperationNameHandler(c *bm.Context) {
+	req := new(ListOperationNameReq)
+	if err := c.Bind(req); err != nil {
+		return
+	}
+	reply, err := b.ListOperationName(c.Context, req)
+	if err != nil {
+		c.JSON(nil, err)
+		return
+	}
+	body := &bytes.Buffer{}
+	marshaler := jsonpb.Marshaler{EmitDefaults: true, OrigName: true}
+	err = marshaler.Marshal(body, reply)
+	c.JSON(json.RawMessage(body.Bytes()), err)
+}
+
+func (b *_BMServerDapperQuery) bmDapperQueryListSpanHandler(c *bm.Context) {
+	req := new(ListSpanReq)
+	if err := c.Bind(req); err != nil {
+		return
+	}
+	reply, err := b.ListSpan(c.Context, req)
+	if err != nil {
+		c.JSON(nil, err)
+		return
+	}
+	body := &bytes.Buffer{}
+	marshaler := jsonpb.Marshaler{EmitDefaults: true, OrigName: true}
+	err = marshaler.Marshal(body, reply)
+	c.JSON(json.RawMessage(body.Bytes()), err)
+}
+
+func (b *_BMServerDapperQuery) bmDapperQueryTraceHandler(c *bm.Context) {
+	req := new(TraceReq)
+	if err := c.Bind(req); err != nil {
+		return
+	}
+	reply, err := b.Trace(c.Context, req)
+	if err != nil {
+		c.JSON(nil, err)
+		return
+	}
+	body := &bytes.Buffer{}
+	marshaler := jsonpb.Marshaler{EmitDefaults: true, OrigName: true}
+	err = marshaler.Marshal(body, reply)
+	c.JSON(json.RawMessage(body.Bytes()), err)
+}
+
+func (b *_BMServerDapperQuery) bmDapperQueryRawTraceHandler(c *bm.Context) {
+	req := new(RawTraceReq)
+	if err := c.Bind(req); err != nil {
+		return
+	}
+	reply, err := b.RawTrace(c.Context, req)
+	if err != nil {
+		c.JSON(nil, err)
+		return
+	}
+	body := &bytes.Buffer{}
+	marshaler := jsonpb.Marshaler{EmitDefaults: true, OrigName: true}
+	err = marshaler.Marshal(body, reply)
+	c.JSON(json.RawMessage(body.Bytes()), err)
+}
+
+func (b *_BMServerDapperQuery) bmDapperQueryOperationNameRankHandler(c *bm.Context) {
+	req := new(OperationNameRankReq)
+	if err := c.Bind(req); err != nil {
+		return
+	}
+	reply, err := b.OperationNameRank(c.Context, req)
+	if err != nil {
+		c.JSON(nil, err)
+		return
+	}
+	body := &bytes.Buffer{}
+	marshaler := jsonpb.Marshaler{EmitDefaults: true, OrigName: true}
+	err = marshaler.Marshal(body, reply)
+	c.JSON(json.RawMessage(body.Bytes()), err)
+}
+
+func (b *_BMServerDapperQuery) bmDapperQueryDependsRankHandler(c *bm.Context) {
+	req := new(DependsRankReq)
+	if err := c.Bind(req); err != nil {
+		return
+	}
+	reply, err := b.DependsRank(c.Context, req)
+	if err != nil {
+		c.JSON(nil, err)
+		return
+	}
+	body := &bytes.Buffer{}
+	marshaler := jsonpb.Marshaler{EmitDefaults: true, OrigName: true}
+	err = marshaler.Marshal(body, reply)
+	c.JSON(json.RawMessage(body.Bytes()), err)
+}
+
+func (b *_BMServerDapperQuery) bmDapperQuerySpanSeriesHandler(c *bm.Context) {
+	req := new(SpanSeriesReq)
+	if err := c.Bind(req); err != nil {
+		return
+	}
+	reply, err := b.SpanSeries(c.Context, req)
+	if err != nil {
+		c.JSON(nil, err)
+		return
+	}
+	body := &bytes.Buffer{}
+	marshaler := jsonpb.Marshaler{EmitDefaults: true, OrigName: true}
+	err = marshaler.Marshal(body, reply)
+	c.JSON(json.RawMessage(body.Bytes()), err)
+}
+
+func (b *_BMServerDapperQuery) bmDapperQuerySamplePointHandler(c *bm.Context) {
+	req := new(SamplePointReq)
+	if err := c.Bind(req); err != nil {
+		return
+	}
+	reply, err := b.SamplePoint(c.Context, req)
+	if err != nil {
+		c.JSON(nil, err)
+		return
+	}
+	body := &bytes.Buffer{}
+	marshaler := jsonpb.Marshaler{EmitDefaults: true, OrigName: true}
+	err = marshaler.Marshal(body, reply)
+	c.JSON(json.RawMessage(body.Bytes()), err)
+}
+
+func (b *_BMServerDapperQuery) bmDapperQueryCltStatusHandler(c *bm.Context) {
+	req := new(CltStatusReq)
+	if err := c.Bind(req); err != nil {
+		return
+	}
+	reply, err := b.CltStatus(c.Context, req)
+	if err != nil {
+		c.JSON(nil, err)
+		return
+	}
+	body := &bytes.Buffer{}
+	marshaler := jsonpb.Marshaler{EmitDefaults: true, OrigName: true}
+	err = marshaler.Marshal(body, reply)
+	c.JSON(json.RawMessage(body.Bytes()), err)
+}
+
+func (b *_BMServerDapperQuery) bmDapperQueryDependsTopologyHandler(c *bm.Context) {
+	req := new(DependsTopologyReq)
+	if err := c.Bind(req); err != nil {
+		return
+	}
+	reply, err := b.DependsTopology(c.Context, req)
+	if err != nil {
+		c.JSON(nil, err)
+		return
+	}
+	body := &bytes.Buffer{}
+	marshaler := jsonpb.Marshaler{EmitDefaults: true, OrigName: true}
+	err = marshaler.Marshal(body, reply)
+	c.JSON(json.RawMessage(body.Bytes()), err)
+}
+
+func (b *_BMServerDapperQuery) bmDapperQueryOpsLogHandler(c *bm.Context) {
+	req := new(OpsLogReq)
+	if err := c.Bind(req); err != nil {
+		return
+	}
+	reply, err := b.OpsLog(c.Context, req)
+	if err != nil {
+		c.JSON(nil, err)
+		return
+	}
+	body := &bytes.Buffer{}
+	marshaler := jsonpb.Marshaler{EmitDefaults: true, OrigName: true}
+	err = marshaler.Marshal(body, reply)
+	c.JSON(json.RawMessage(body.Bytes()), err)
+}
+
+func (b *_BMServerDapperQuery) bmDapperQueryServiceDependHandler(c *bm.Context) {
+	req := new(ServiceDependReq)
+	if err := c.Bind(req); err != nil {
+		return
+	}
+	reply, err := b.ServiceDepend(c.Context, req)
+	if err != nil {
+		c.JSON(nil, err)
+		return
+	}
+	body := &bytes.Buffer{}
+	marshaler := jsonpb.Marshaler{EmitDefaults: true, OrigName: true}
+	err = marshaler.Marshal(body, reply)
+	c.JSON(json.RawMessage(body.Bytes()), err)
+}
+
+// RegisterDapperQueryBMServer register bm server
+func RegisterDapperQueryBMServer(e *bm.Engine, s BMDapperQueryServer) {
+	bs := &_BMServerDapperQuery{s}
+	e.GET("/x/internal/dapper/service-names", bs.bmDapperQueryListServiceNameHandler)
+	e.GET("/x/internal/dapper/operation-names", bs.bmDapperQueryListOperationNameHandler)
+	e.GET("/x/internal/dapper/list-span", bs.bmDapperQueryListSpanHandler)
+	e.GET("/x/internal/dapper/trace", bs.bmDapperQueryTraceHandler)
+	e.GET("/x/internal/dapper/raw-trace", bs.bmDapperQueryRawTraceHandler)
+	e.GET("/x/internal/dapper/operation-names-rank", bs.bmDapperQueryOperationNameRankHandler)
+	e.GET("/x/internal/dapper/depends-rank", bs.bmDapperQueryDependsRankHandler)
+	e.GET("/x/internal/dapper/span-series", bs.bmDapperQuerySpanSeriesHandler)
+	e.GET("/x/internal/dapper/sample-point", bs.bmDapperQuerySamplePointHandler)
+	e.GET("/x/internal/dapper/clt-status", bs.bmDapperQueryCltStatusHandler)
+	e.GET("/x/internal/dapper/depends-topology", bs.bmDapperQueryDependsTopologyHandler)
+	e.GET("/x/internal/dapper/ops-log", bs.bmDapperQueryOpsLogHandler)
+	e.GET("/x/internal/dapper/service-depend", bs.bmDapperQueryServiceDependHandler)
+}

app/service/main/dapper-query/api/v1/api.proto

@@ -0,0 +1,348 @@
+syntax = "proto3";
+
+import "google/api/annotations.proto";
+import "github.com/gogo/protobuf/gogoproto/gogo.proto";
+
+package dapper.query.v1;
+
+option go_package = "v1";
+
+message ListServiceNameReq {}
+
+message ListServiceNameReply {
+  repeated string service_names = 1;
+}
+
+message ListOperationNameReq {
+  string service_name = 1 [(gogoproto.moretags) = "form:\"service_name\" validate:\"required\""];
+}
+
+message ListOperationNameReply {
+  repeated string operation_names = 1;
+}
+
+message ListSpanReq {
+  string service_name = 1 [(gogoproto.moretags) = "form:\"service_name\" validate:\"required\""];
+  string operation_name = 2 [(gogoproto.moretags) = "form:\"operation_name\" validate:\"required\""];
+  int64 start = 3 [(gogoproto.moretags) = "form:\"start\""];
+  int64 end = 4 [(gogoproto.moretags) = "form:\"end\""];
+  // 目前支持的 order 
+  // time:desc time:asc 按时间排序
+  // duration:desc duration:asc 按耗时排序
+  string order = 5 [(gogoproto.moretags) = "form:\"order\""];
+  // 只显示 error 的 span
+  bool only_error = 6 [(gogoproto.moretags) = "form:\"only_error\""];
+  int32 offset = 7 [(gogoproto.moretags) = "form:\"offset\""];
+  int32 limit = 8 [(gogoproto.moretags) = "form:\"limit\""];
+}
+
+message SpanListItem {
+  string trace_id = 1;
+  string span_id = 2;
+  string parent_id = 3;
+  string service_name = 4;
+  string operation_name = 5;
+  string start_time = 6; // span 开始时间
+  string duration = 7; // span 耗时
+  map<string, TagValue> tags = 12;
+  // Deprecated: use tags
+  bool is_error = 8; // 是否发生错误
+  string container_ip = 9;
+  string region_zone = 10;
+  string mark = 11;
+}
+
+message TraceReq {
+  string trace_id = 1 [(gogoproto.moretags) = "form:\"trace_id\" validate:\"required\""];
+  string span_id = 2 [(gogoproto.moretags) = "form:\"span_id\""];
+}
+
+message RawTraceReq {
+  string trace_id = 1 [(gogoproto.moretags) = "form:\"trace_id\" validate:\"required\""];
+};
+
+message RawTraceReply {
+  repeated Span items = 1;
+}
+
+message TagValue {
+  oneof value {
+    string string_value = 2;
+    int64 int64_value = 3;
+    bool bool_value = 4;
+    float float_value = 5;
+  }
+}
+
+message Field {
+  string key = 1;
+  string value = 2;
+}
+
+message Log {
+  int64 timestamp = 1;
+  repeated Field fields = 2;
+}
+
+message Span {
+  string service_name = 1;
+  string operation_name = 2;
+  string trace_id = 3;
+  string span_id = 4;
+  string parent_id = 5;
+  int64 start_time = 6;
+  int64 duration = 7;
+  map<string, TagValue> tags = 8;
+  repeated Log logs = 9;
+  int32 level = 10;
+  repeated Span childs = 11;
+}
+
+message TraceReply {
+  int32 service_count = 1;
+  int32 span_count = 2;
+  int32 max_level = 3;
+  Span root = 4;
+}
+
+
+message ListSpanReply {
+  repeated SpanListItem items = 2;
+}
+
+message OperationNameRankReq {
+  string service_name = 1 [(gogoproto.moretags) = "form:\"service_name\" validate:\"required\""];
+  int64 start = 2 [(gogoproto.moretags) = "form:\"start\""];
+  int64 end = 3 [(gogoproto.moretags) = "form:\"end\""];
+  // 排序类型 max_duration 最大耗时, min_duration 最小耗时, avg_duration 平均耗时, errors 错误数
+  string rank_type = 4 [(gogoproto.moretags) = "form:\"rank_type\""];
+}
+
+message RankItem {
+  string service_name = 1;
+  string operation_name = 2;
+  // 当 rank type 是 max_duration, min_duration, avg_duration 时 value 是纳秒
+  // 当 rank type 是 errors 是 value 是错误数
+  double value = 3;
+}
+
+message OperationNameRankReply {
+  string rank_type = 1;
+  repeated RankItem items = 2;
+}
+
+message DependsRankReq {
+  string service_name = 1 [(gogoproto.moretags) = "form:\"service_name\" validate:\"required\""];
+  int64 start = 3 [(gogoproto.moretags) = "form:\"start\""];
+  int64 end = 4 [(gogoproto.moretags) = "form:\"end\""];
+  // 排序类型 max_duration 最大耗时, min_duration 最小耗时, avg_duration 平均耗时, errors 错误数
+  string rank_type = 5 [(gogoproto.moretags) = "form:\"rank_type\""];
+}
+
+message DependsRankReply {
+  string rank_type = 1;
+  repeated RankItem items = 2;
+}
+
+message SpanSeriesReq {
+  string service_name = 1 [(gogoproto.moretags) = "form:\"service_name\" validate:\"required\""];
+  string operation_name = 2 [(gogoproto.moretags) = "form:\"operation_name\" validate:\"required\""];
+  int64 start = 3 [(gogoproto.moretags) = "form:\"start\""];
+  int64 end = 4 [(gogoproto.moretags) = "form:\"end\""];
+  // 可选的 fields 有 max_duration, min_duration, avg_duration, errors
+  // 其中除 errors 返回的是一段时间内的总数 其他返回的都是平均数
+  // fields 是个数组可以通过 fields=max_duration,min_duration,avg_duration 逗号分隔
+  string fields = 6 [(gogoproto.moretags) = "form:\"fields\""];
+}
+
+message SeriesItem {
+  // 名称一般是请求的 field+{count|mean}
+  string field = 1;
+  repeated int64 values = 2 [(gogoproto.customtype) = "*int64"];
+}
+
+message SpanSeriesReply {
+  // 返回点的间隔
+  int64 interval = 5;
+  repeated string times = 1;
+  repeated SeriesItem items = 2;
+}
+
+message CltStatusReq {}
+
+message Client {
+  string addr = 1;
+  int64 err_count = 2;
+  int64 rate = 3;
+  int64 up_time = 4; 
+}
+
+message CltNode {
+  string node = 1;
+  int64 queue_len = 2;
+  repeated Client clients = 3;
+}
+
+message CltStatusReply {
+  repeated CltNode nodes = 1;
+}
+
+message SamplePointReq {
+  string service_name = 1 [(gogoproto.moretags) = "form:\"service_name\" validate:\"required\""];
+  string operation_name = 2 [(gogoproto.moretags) = "form:\"operation_name\" validate:\"required\""];
+  // only_error 在 errors 那个图可以指定为 true
+  bool only_error = 3 [(gogoproto.moretags) = "form:\"only_error\""];
+  // interval 使用 span-series 返回的 interval 即可
+  int64 interval = 5 [(gogoproto.moretags) = "form:\"interval\" validate:\"required\""];
+  // time 使用 time-series 返回的时间即可，相同格式型如 2006-01-02T15:04:05
+  string time = 6 [(gogoproto.moretags) = "form:\"time\" validate:\"required\""];
+}
+
+message SamplePointItem {
+  string trace_id = 1;
+  string span_id = 2;
+  int64 duration = 3;
+  bool is_error = 4;
+}
+
+message SamplePointReply {
+  repeated SamplePointItem items = 1;
+}
+
+message DependsTopologyReq {}
+
+message DependsTopologyItem {
+  string service_name = 1;
+  string depend_on = 2;
+}
+
+message DependsTopologyReply {
+  repeated DependsTopologyItem items = 1;
+}
+
+message OpsLogReq {
+  string trace_id = 1 [(gogoproto.moretags) = "form:\"trace_id\" validate:\"required\""];
+  string span_id = 2 [(gogoproto.moretags) = "form:\"span_id\""];
+  string trace_field = 3 [(gogoproto.moretags) = "form:\"trace_field\""];
+  string service_name = 4 [(gogoproto.moretags) = "form:\"service_name\""];
+  string operation_name = 5 [(gogoproto.moretags) = "form:\"operation_name\""];
+  // 开始时间
+  int64 start = 6 [(gogoproto.moretags) = "form:\"start\""];
+  // 结束时间
+  int64 end = 7[(gogoproto.moretags) = "form:\"end\""];
+}
+
+message OpsLogRecord {
+  string time = 1;
+  map<string, TagValue> fields = 2;
+  string level = 3;
+  string message = 4;
+}
+
+message OpsLogReply {
+  repeated OpsLogRecord records = 1;
+}
+
+message ServiceDependReq {
+  // service_name 不解释!
+  string service_name = 1 [(gogoproto.moretags) = "form:\"service_name\" validate:\"required\""];
+  // operation_name 当 operation_name 为空时查询所有 operation_name 然后 merge 结果
+  string operation_name = 2 [(gogoproto.moretags) = "form:\"operation_name\""];
+}
+
+message ServiceDependReply {
+  repeated ServiceDependItem items = 1;
+}
+
+message ServiceDependItem {
+  // service_name 依赖服务名称, service 为 AppID 其他为组件名 mysql, redis, http 等
+  string service_name = 1;
+  // component, 通讯组件 e.g. net/http, goRPC, gRPC
+  string component = 2;
+  // operation_names 被依赖服务的 operation_names, mysql, redis 等为空
+  repeated string operation_names = 3;
+}
+
+// DapperQuery dapper 查询服务
+service DapperQuery {
+  // ListServiceName 列出所有 service
+  rpc ListServiceName(ListServiceNameReq) returns (ListServiceNameReply) {
+    option (google.api.http) = {
+        get: "/x/internal/dapper/service-names";
+    };
+  }
+  // ListOperationName 列出某一 service  下所有 operation_name 仅 span.kind 为 server 的 operation_name
+  rpc ListOperationName(ListOperationNameReq) returns (ListOperationNameReply) {
+    option (google.api.http) = {
+      get: "/x/internal/dapper/operation-names";
+    };
+  }
+  // ListSpan 列出一个 service_name 某一 operation_name 所有采样到 Span
+  rpc ListSpan(ListSpanReq) returns (ListSpanReply) {
+    option (google.api.http) = {
+      get: "/x/internal/dapper/list-span";
+    };
+  }
+  // Trace 查询一个 Trace
+  rpc Trace(TraceReq) returns (TraceReply) {
+    option (google.api.http) = {
+      get: "/x/internal/dapper/trace";
+    };
+  }
+  // RawTrace 原始 Trace 数据
+  rpc RawTrace(RawTraceReq) returns (RawTraceReply) {
+    option (google.api.http) = {
+      get: "/x/internal/dapper/raw-trace";
+    };
+  }
+  // OperationNameRank 查询 OperationName 排名列表
+  rpc OperationNameRank(OperationNameRankReq) returns(OperationNameRankReply) {
+    option (google.api.http) = {
+      get: "/x/internal/dapper/operation-names-rank";
+    };
+  }
+  // DependsRank 查询某一个 service_name:operation_name 下所有依赖组件排名
+  rpc DependsRank(DependsRankReq) returns(DependsRankReply) {
+    option (google.api.http) = {
+      get: "/x/internal/dapper/depends-rank";
+    };
+  }
+  // SpanSeries 获取 span 的时间序列数据
+  rpc SpanSeries(SpanSeriesReq) returns (SpanSeriesReply) {
+    option (google.api.http) = {
+      get: "/x/internal/dapper/span-series";
+    };
+  }
+  // SamplePoint 获取采样点数据
+  rpc SamplePoint(SamplePointReq) returns(SamplePointReply) {
+    option (google.api.http) = {
+      get: "/x/internal/dapper/sample-point";
+    };
+  }
+  // CltStatus 获取 collector 信息
+  rpc CltStatus(CltStatusReq) returns(CltStatusReply) {
+    option (google.api.http) = {
+      get: "/x/internal/dapper/clt-status";
+    };
+  }
+  // DependsTopology 获取依赖拓扑图
+  rpc DependsTopology(DependsTopologyReq) returns (DependsTopologyReply) {
+    option (google.api.http) = {
+      get: "/x/internal/dapper/depends-topology";
+    }; 
+  }
+  // OpsLog 获取 通过 trace-id 获取 opslog 记录
+  // 如果请求的 trace-id 没有被记录到, 则需要提供 service_name operation_name 和 timestamp 进行模糊查询
+  rpc OpsLog(OpsLogReq) returns (OpsLogReply) {
+    option (google.api.http) = {
+      get: "/x/internal/dapper/ops-log";
+    }; 
+  }
+  // ServiceDepend 查询服务的直接依赖
+  // TODO: 通过最近收集的到3 个 span 实时计算的，在当前查询的服务出现不正常的时候，查询结果可能不准确
+  rpc ServiceDepend(ServiceDependReq) returns (ServiceDependReply) {
+    option (google.api.http) = {
+      get: "/x/internal/dapper/service-depend";
+    }; 
+  }
+}

app/service/main/dapper-query/api/v1/api.swagger.json

@@ -0,0 +1,974 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "api/v1/api.proto",
+    "version": "version not set"
+  },
+  "schemes": [
+    "http",
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "paths": {
+    "/x/internal/dapper/clt-status": {
+      "get": {
+        "summary": "CltStatus 获取 collector 信息",
+        "operationId": "CltStatus",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1CltStatusReply"
+            }
+          }
+        },
+        "tags": [
+          "DapperQuery"
+        ]
+      }
+    },
+    "/x/internal/dapper/depends-rank": {
+      "get": {
+        "summary": "DependsRank 查询某一个 service_name:operation_name 下所有依赖组件排名",
+        "operationId": "DependsRank",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1DependsRankReply"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "service_name",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "start",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "int64"
+          },
+          {
+            "name": "end",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "int64"
+          },
+          {
+            "name": "rank_type",
+            "description": "排序类型 max_duration 最大耗时, min_duration 最小耗时, avg_duration 平均耗时, errors 错误数.",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "tags": [
+          "DapperQuery"
+        ]
+      }
+    },
+    "/x/internal/dapper/depends-topology": {
+      "get": {
+        "summary": "DependsTopology 获取依赖拓扑图",
+        "operationId": "DependsTopology",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1DependsTopologyReply"
+            }
+          }
+        },
+        "tags": [
+          "DapperQuery"
+        ]
+      }
+    },
+    "/x/internal/dapper/list-span": {
+      "get": {
+        "summary": "ListSpan 列出一个 service_name 某一 operation_name 所有采样到 Span",
+        "operationId": "ListSpan",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1ListSpanReply"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "service_name",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "operation_name",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "start",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "int64"
+          },
+          {
+            "name": "end",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "int64"
+          },
+          {
+            "name": "order",
+            "description": "目前支持的 order \ntime:desc time:asc 按时间排序\nduration:desc duration:asc 按耗时排序.",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "only_error",
+            "description": "只显示 error 的 span.",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "format": "boolean"
+          },
+          {
+            "name": "offset",
+            "in": "query",
+            "required": false,
+            "type": "integer",
+            "format": "int32"
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "required": false,
+            "type": "integer",
+            "format": "int32"
+          }
+        ],
+        "tags": [
+          "DapperQuery"
+        ]
+      }
+    },
+    "/x/internal/dapper/operation-names": {
+      "get": {
+        "summary": "ListOperationName 列出某一 service  下所有 operation_name 仅 span.kind 为 server 的 operation_name",
+        "operationId": "ListOperationName",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1ListOperationNameReply"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "service_name",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "tags": [
+          "DapperQuery"
+        ]
+      }
+    },
+    "/x/internal/dapper/operation-names-rank": {
+      "get": {
+        "summary": "OperationNameRank 查询 OperationName 排名列表",
+        "operationId": "OperationNameRank",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1OperationNameRankReply"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "service_name",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "start",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "int64"
+          },
+          {
+            "name": "end",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "int64"
+          },
+          {
+            "name": "rank_type",
+            "description": "排序类型 max_duration 最大耗时, min_duration 最小耗时, avg_duration 平均耗时, errors 错误数.",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "tags": [
+          "DapperQuery"
+        ]
+      }
+    },
+    "/x/internal/dapper/ops-log": {
+      "get": {
+        "summary": "OpsLog 获取 通过 trace-id 获取 opslog 记录\n如果请求的 trace-id 没有被记录到, 则需要提供 service_name operation_name 和 timestamp 进行模糊查询",
+        "operationId": "OpsLog",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1OpsLogReply"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "trace_id",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "span_id",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "trace_field",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "service_name",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "operation_name",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "start",
+            "description": "开始时间.",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "int64"
+          },
+          {
+            "name": "end",
+            "description": "结束时间.",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "int64"
+          }
+        ],
+        "tags": [
+          "DapperQuery"
+        ]
+      }
+    },
+    "/x/internal/dapper/raw-trace": {
+      "get": {
+        "summary": "RawTrace 原始 Trace 数据",
+        "operationId": "RawTrace",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1RawTraceReply"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "trace_id",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "tags": [
+          "DapperQuery"
+        ]
+      }
+    },
+    "/x/internal/dapper/sample-point": {
+      "get": {
+        "summary": "SamplePoint 获取采样点数据",
+        "operationId": "SamplePoint",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1SamplePointReply"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "service_name",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "operation_name",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "only_error",
+            "description": "only_error 在 errors 那个图可以指定为 true.",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "format": "boolean"
+          },
+          {
+            "name": "interval",
+            "description": "interval 使用 span-series 返回的 interval 即可.",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "int64"
+          },
+          {
+            "name": "time",
+            "description": "time 使用 time-series 返回的时间即可，相同格式型如 2006-01-02T15:04:05.",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "tags": [
+          "DapperQuery"
+        ]
+      }
+    },
+    "/x/internal/dapper/service-depend": {
+      "get": {
+        "summary": "ServiceDepend 查询服务的直接依赖\nTODO: 通过最近收集的到3 个 span 实时计算的，在当前查询的服务出现不正常的时候，查询结果可能不准确",
+        "operationId": "ServiceDepend",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1ServiceDependReply"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "service_name",
+            "description": "service_name 不解释!.",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "operation_name",
+            "description": "operation_name 当 operation_name 为空时查询所有 operation_name 然后 merge 结果.",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "tags": [
+          "DapperQuery"
+        ]
+      }
+    },
+    "/x/internal/dapper/service-names": {
+      "get": {
+        "summary": "ListServiceName 列出所有 service",
+        "operationId": "ListServiceName",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1ListServiceNameReply"
+            }
+          }
+        },
+        "tags": [
+          "DapperQuery"
+        ]
+      }
+    },
+    "/x/internal/dapper/span-series": {
+      "get": {
+        "summary": "SpanSeries 获取 span 的时间序列数据",
+        "operationId": "SpanSeries",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1SpanSeriesReply"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "service_name",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "operation_name",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "start",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "int64"
+          },
+          {
+            "name": "end",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "format": "int64"
+          },
+          {
+            "name": "fields",
+            "description": "可选的 fields 有 max_duration, min_duration, avg_duration, errors\n其中除 errors 返回的是一段时间内的总数 其他返回的都是平均数\nfields 是个数组可以通过 fields=max_duration,min_duration,avg_duration 逗号分隔.",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "tags": [
+          "DapperQuery"
+        ]
+      }
+    },
+    "/x/internal/dapper/trace": {
+      "get": {
+        "summary": "Trace 查询一个 Trace",
+        "operationId": "Trace",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/v1TraceReply"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "trace_id",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "span_id",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "tags": [
+          "DapperQuery"
+        ]
+      }
+    }
+  },
+  "definitions": {
+    "v1Client": {
+      "type": "object",
+      "properties": {
+        "addr": {
+          "type": "string"
+        },
+        "err_count": {
+          "type": "string",
+          "format": "int64"
+        },
+        "rate": {
+          "type": "string",
+          "format": "int64"
+        },
+        "up_time": {
+          "type": "string",
+          "format": "int64"
+        }
+      }
+    },
+    "v1CltNode": {
+      "type": "object",
+      "properties": {
+        "node": {
+          "type": "string"
+        },
+        "queue_len": {
+          "type": "string",
+          "format": "int64"
+        },
+        "clients": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/v1Client"
+          }
+        }
+      }
+    },
+    "v1CltStatusReply": {
+      "type": "object",
+      "properties": {
+        "nodes": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/v1CltNode"
+          }
+        }
+      }
+    },
+    "v1DependsRankReply": {
+      "type": "object",
+      "properties": {
+        "rank_type": {
+          "type": "string"
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/v1RankItem"
+          }
+        }
+      }
+    },
+    "v1DependsTopologyItem": {
+      "type": "object",
+      "properties": {
+        "service_name": {
+          "type": "string"
+        },
+        "depend_on": {
+          "type": "string"
+        }
+      }
+    },
+    "v1DependsTopologyReply": {
+      "type": "object",
+      "properties": {
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/v1DependsTopologyItem"
+          }
+        }
+      }
+    },
+    "v1Field": {
+      "type": "object",
+      "properties": {
+        "key": {
+          "type": "string"
+        },
+        "value": {
+          "type": "string"
+        }
+      }
+    },
+    "v1ListOperationNameReply": {
+      "type": "object",
+      "properties": {
+        "operation_names": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "v1ListServiceNameReply": {
+      "type": "object",
+      "properties": {
+        "service_names": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "v1ListSpanReply": {
+      "type": "object",
+      "properties": {
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/v1SpanListItem"
+          }
+        }
+      }
+    },
+    "v1Log": {
+      "type": "object",
+      "properties": {
+        "timestamp": {
+          "type": "string",
+          "format": "int64"
+        },
+        "fields": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/v1Field"
+          }
+        }
+      }
+    },
+    "v1OperationNameRankReply": {
+      "type": "object",
+      "properties": {
+        "rank_type": {
+          "type": "string"
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/v1RankItem"
+          }
+        }
+      }
+    },
+    "v1OpsLogRecord": {
+      "type": "object",
+      "properties": {
+        "time": {
+          "type": "string"
+        },
+        "fields": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/v1TagValue"
+          }
+        },
+        "level": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        }
+      }
+    },
+    "v1OpsLogReply": {
+      "type": "object",
+      "properties": {
+        "records": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/v1OpsLogRecord"
+          }
+        }
+      }
+    },
+    "v1RankItem": {
+      "type": "object",
+      "properties": {
+        "service_name": {
+          "type": "string"
+        },
+        "operation_name": {
+          "type": "string"
+        },
+        "value": {
+          "type": "number",
+          "format": "double",
+          "title": "当 rank type 是 max_duration, min_duration, avg_duration 时 value 是纳秒\n当 rank type 是 errors 是 value 是错误数"
+        }
+      }
+    },
+    "v1RawTraceReply": {
+      "type": "object",
+      "properties": {
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/v1Span"
+          }
+        }
+      }
+    },
+    "v1SamplePointItem": {
+      "type": "object",
+      "properties": {
+        "trace_id": {
+          "type": "string"
+        },
+        "span_id": {
+          "type": "string"
+        },
+        "duration": {
+          "type": "string",
+          "format": "int64"
+        },
+        "is_error": {
+          "type": "boolean",
+          "format": "boolean"
+        }
+      }
+    },
+    "v1SamplePointReply": {
+      "type": "object",
+      "properties": {
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/v1SamplePointItem"
+          }
+        }
+      }
+    },
+    "v1SeriesItem": {
+      "type": "object",
+      "properties": {
+        "field": {
+          "type": "string",
+          "title": "名称一般是请求的 field+{count|mean}"
+        },
+        "values": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "format": "int64"
+          }
+        }
+      }
+    },
+    "v1ServiceDependItem": {
+      "type": "object",
+      "properties": {
+        "service_name": {
+          "type": "string",
+          "title": "service_name 依赖服务名称, service 为 AppID 其他为组件名 mysql, redis, http 等"
+        },
+        "component": {
+          "type": "string",
+          "title": "component, 通讯组件 e.g. net/http, goRPC, gRPC"
+        },
+        "operation_names": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "title": "operation_names 被依赖服务的 operation_names, mysql, redis 等为空"
+        }
+      }
+    },
+    "v1ServiceDependReply": {
+      "type": "object",
+      "properties": {
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/v1ServiceDependItem"
+          }
+        }
+      }
+    },
+    "v1Span": {
+      "type": "object",
+      "properties": {
+        "service_name": {
+          "type": "string"
+        },
+        "operation_name": {
+          "type": "string"
+        },
+        "trace_id": {
+          "type": "string"
+        },
+        "span_id": {
+          "type": "string"
+        },
+        "parent_id": {
+          "type": "string"
+        },
+        "start_time": {
+          "type": "string",
+          "format": "int64"
+        },
+        "duration": {
+          "type": "string",
+          "format": "int64"
+        },
+        "tags": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/v1TagValue"
+          }
+        },
+        "logs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/v1Log"
+          }
+        },
+        "level": {
+          "type": "integer",
+          "format": "int32"
+        },
+        "childs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/v1Span"
+          }
+        }
+      }
+    },
+    "v1SpanListItem": {
+      "type": "object",
+      "properties": {
+        "trace_id": {
+          "type": "string"
+        },
+        "span_id": {
+          "type": "string"
+        },
+        "parent_id": {
+          "type": "string"
+        },
+        "service_name": {
+          "type": "string"
+        },
+        "operation_name": {
+          "type": "string"
+        },
+        "start_time": {
+          "type": "string"
+        },
+        "duration": {
+          "type": "string"
+        },
+        "tags": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/v1TagValue"
+          }
+        },
+        "is_error": {
+          "type": "boolean",
+          "format": "boolean",
+          "title": "Deprecated: use tags"
+        },
+        "container_ip": {
+          "type": "string"
+        },
+        "region_zone": {
+          "type": "string"
+        },
+        "mark": {
+          "type": "string"
+        }
+      }
+    },
+    "v1SpanSeriesReply": {
+      "type": "object",
+      "properties": {
+        "interval": {
+          "type": "string",
+          "format": "int64",
+          "title": "返回点的间隔"
+        },
+        "times": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/v1SeriesItem"
+          }
+        }
+      }
+    },
+    "v1TagValue": {
+      "type": "object",
+      "properties": {
+        "string_value": {
+          "type": "string"
+        },
+        "int64_value": {
+          "type": "string",
+          "format": "int64"
+        },
+        "bool_value": {
+          "type": "boolean",
+          "format": "boolean"
+        },
+        "float_value": {
+          "type": "number",
+          "format": "float"
+        }
+      }
+    },
+    "v1TraceReply": {
+      "type": "object",
+      "properties": {
+        "service_count": {
+          "type": "integer",
+          "format": "int32"
+        },
+        "span_count": {
+          "type": "integer",
+          "format": "int32"
+        },
+        "max_level": {
+          "type": "integer",
+          "format": "int32"
+        },
+        "root": {
+          "$ref": "#/definitions/v1Span"
+        }
+      }
+    }
+  }
+}

app/service/main/dapper-query/api/v1/marshal.go

@@ -0,0 +1,57 @@
+package v1
+
+import (
+	"encoding/json"
+
+	"go-common/app/tool/protoc-gen-bm/jsonpb"
+)
+
+// MarshalJSON .
+func (t *TagValue) MarshalJSON() ([]byte, error) {
+	return json.Marshal(t.Value)
+}
+
+// MarshalJSON .
+func (t *TagValue_StringValue) MarshalJSON() ([]byte, error) {
+	return json.Marshal(t.StringValue)
+}
+
+// MarshalJSON .
+func (t *TagValue_Int64Value) MarshalJSON() ([]byte, error) {
+	return json.Marshal(t.Int64Value)
+}
+
+// MarshalJSON .
+func (t *TagValue_BoolValue) MarshalJSON() ([]byte, error) {
+	return json.Marshal(t.BoolValue)
+}
+
+// MarshalJSON .
+func (t *TagValue_FloatValue) MarshalJSON() ([]byte, error) {
+	return json.Marshal(t.FloatValue)
+}
+
+// MarshalJSONPB .
+func (t *TagValue) MarshalJSONPB(*jsonpb.Marshaler) ([]byte, error) {
+	return json.Marshal(t.Value)
+}
+
+// MarshalJSONPB .
+func (t *TagValue_StringValue) MarshalJSONPB(*jsonpb.Marshaler) ([]byte, error) {
+	return json.Marshal(t.StringValue)
+}
+
+// MarshalJSONPB .
+func (t *TagValue_Int64Value) MarshalJSONPB(*jsonpb.Marshaler) ([]byte, error) {
+	return json.Marshal(t.Int64Value)
+}
+
+// MarshalJSONPB .
+func (t *TagValue_BoolValue) MarshalJSONPB(*jsonpb.Marshaler) ([]byte, error) {
+	return json.Marshal(t.BoolValue)
+}
+
+// MarshalJSONPB .
+func (t *TagValue_FloatValue) MarshalJSONPB(*jsonpb.Marshaler) ([]byte, error) {
+	return json.Marshal(t.FloatValue)
+}