# 获取event的详情 - ShowEventDetail #### 功能介绍 获取event的详情。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-apm/apm_04_0007.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-apm/apm_04_0021.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | apm:application:getTraceEvents | Write | - | g:EnterpriseProjectId | - apm:apm2TraceEvent:get - apm:apm2TraceEvents:get - apm:apm2BusinessSpanSearch:get | - | #### URI GET /v1/apm2/openapi/view/trace/get-event-detail 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | trace_id | 是 | String | trace id。 | | span_id | 是 | String | span id。 | | event_id | 是 | String | event id。 | | env_id | 是 | Long | 环境id。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 从IAM服务获取的用户Token。 | #### 响应参数 **状态码： 200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | event_info | [SpanEventInfo] object | event详情信息。 | 表4SpanEventInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | env_name | String | 环境名称。 | | app_name | String | 组件名称。 | | indent | Integer | 缩进。 | | region | String | 区域。 | | host_name | String | 主机名称。 | | ip_address | String | ip地址。 | | instance_name | String | 实例名称。 | | event_id | String | event的ID，在一个具体的span下面event的编号，一般是1-1-2这种格式。 | | next_spanId | String | 产生下一个span的源的eventId。 | | source_event_id | String | 调用方的eventid。 | | method | String | 方法名。 | | children_event_count | Integer | 子event的个数。 | | discard | Array of [DiscardInfo] objects | 丢弃的子event个数，key是类型。 | | argument | String | 界面展示的参数，每个类型的event自己来实现。 | | attachment | Map\ | 注册信息里面的attachment。 | | global_trace_id | String | vTraceId，虚拟traceId。 | | global_path | String | 虚拟traceId经过的path路径。 | | trace_id | String | trace id。 | | span_id | String | span id。 | | env_id | Long | 环境id。 | | instance_id | Long | 实例id。 | | app_id | Long | 组件id。 | | biz_id | Long | 应用id。 | | biz_name | String | 应用名称。 | | display_name | String | 应用别名。 | | domain_id | Integer | 租户id。 | | source | String | 只有是根event也就是span的时候有值。 | | real_source | String | 根event的时候存在，实际调用的url。 | | start_time | Long | 开始时间。 | | time_used | Long | 耗时。 | | code | Integer | 状态码，针对http的调用有效。 | | class_name | String | 类名。 | | is_async | Boolean | 是否异步的event。 | | tags | Map\ | 包含用户自定义参数，header或body体里的内容，httpMethod，bizCode，以及后续可能新增参数。 | | has_error | Boolean | 是否有错误，主要用在span的场景。 | | error_reasons | String | 错误原因。 | | type | String | 类型。如：mysql，kafka等。 | | http_method | String | 这里的method实际上是tags里面的http_method，只有url监控项才有。 | | biz_code | String | 业务状态码的采集。 | | id | String | span id。 | 表5DiscardInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | 类型。 | | count | Integer | 数量。 | | totalTime | Long | 总时间。 | #### 请求示例 获取环境id为11，调用链的trace_id为16-1666684411910-1326，span_id为1，event_id为11的event详情。 ``` /v1/apm2/openapi/view/trace/get-event-detail?env_id=11&event_id=1&span_id=1&trace_id=16-1666684411910-1326 ``` #### 响应示例 **状态码： 200** OK，请求响应成功。 ``` { "event_info" : { "global_trace_id" : "16-1666684411910-1326", "global_path" : null, "trace_id" : "16-1666684411910-1326", "span_id" : "1", "env_id" : 11, "instance_id" : 16, "app_id" : 11, "biz_id" : 162, "domain_id" : 1, "source" : "/apm2/health/v1/health-check", "real_source" : "/apm2/health/v1/health-check", "start_time" : 1666684411910, "time_used" : 1, "code" : 200, "class_name" : "org/apache/catalina/core/StandardHostValve", "is_async" : false, "tags" : { "httpMethod" : "GET", "remoteAddr" : "*.*.*.*" }, "has_error" : false, "error_reasons" : null, "type" : "Tomcat", "http_method" : "GET", "biz_code" : null, "event_id" : "1", "next_spanId" : null, "source_event_id" : null, "method" : "invoke", "children_event_count" : 0, "discard" : [ ], "argument" : "(GET)(/apm2/health/v1/health-check)(200)", "attachment" : { "bizName" : "LubanApm", "instanceName" : "apm2-apm-pu-task-6b5bbfc84d-gtrrs:172.16.3.7:default", "envName" : "xxx-roma-2", "appName" : "apm-pu-task", "projectId" : "420a7f6d790349c1bbeec18aefe36404", "domainId" : "f9b2ea53c6eb48078435d499a3b03419" }, "host_name" : "apm2-apm-pu-task-6b5bbfc84d-gtrrs", "ip_address" : "*.*.*.*", "instance_name" : "default", "region" : null, "env_name" : "xxx-roma-2", "app_name" : "apm-pu-task", "indent" : 0, "id" : "1+1" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK，请求响应成功。 | | 400 | Bad Request，语义或参数有误。 | | 401 | Unauthorized，没有权限。 | | 403 | Forbidden，禁止访问。 | | 404 | Not Found，没有找到要请求的资源。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-apm/ErrorCode.html)。