通过日志服务查看API调用日志
API网关和日志服务实现无缝集成，通过日志服务您可以进行实时日志查询、下载、多维度统计分析等，您也可以将日志投递到OSS或者MaxCompute。
日志服务每个月前500MB免费，具体价格请参照：日志服务定价。
1 功能简介
1.1 日志在线查询
可根据日志中任意关键字进行快速的精确、模糊检索，可用于问题定位或者统计查询。
1.2 详细调用日志
您可以检索API调用的详细日志包含如下表所示字段。其中：requestQueryString，requestHeaders, requestBody, responseHeaders, responseBody 几个字段只有VPC专享实例支持，且需要在分组详情页面配置后支持。
日志项 | 描述 |
apiGroupUid | API的分组ID |
apiGroupName | API分组名称 |
apiUid | API的ID |
apiName | API名称 |
apiStageUid | API环境ID |
apiStageName | API环境名称 |
httpMethod | 调用的HTTP方法 |
path | 请求的PATH |
domain | 调用的域名 |
statusCode | HttpStatusCode |
errorMessage | 错误信息 |
appId | 调用者应用ID |
appName | 调用者应用名称 |
clientIp | 调用者客户端IP |
exception | 后端返回的具体错信息 |
providerAliUid | API提供者账户ID |
region | 区域，如：cn-hangzhou |
requestHandleTime | 请求时间，UTC |
requestId | 请求ID，全局唯一 |
requestSize | 请求大小，单位：字节 |
responseSize | 返回数据大小，单位：字节 |
serviceLatency | 访问后端资源耗时总和，包括申请连接资源耗时，建立连接耗时，调用后端服务耗时，单位：毫秒 |
errorCode | 错误码code，如：X500ER |
requestProtocol | 客户端请求协议：HTTP/HTTPS/WS |
instanceId | API服务所在的网关实例ID |
initialRequestId | API网关自调用时，例如API-1调用API-2 ，那么API-2的日志中会用initialRequestId来记录API-1的requestid。 |
clientNonce | 客户端X-Ca-Nonce头 |
requestQueryString | 客户端请求的queryString |
requestHeaders | 客户端请求的header内容 |
requestBody | 客户端请求的body内容，最多1024个字节 |
responseHeaders | API响应的header内容 |
responseBody | API响应的response内容，最多1024个 |
consumerAppKey | API请求的appKey |
totalLatency | API请求的总延迟，单位毫秒 |
customTraceId | 全链路日志的traceId |
jwtClaims | 从JWT中解析出来的Claim，可以在分组上配置 |
plugin | API请求命中的插件列表及相关上下文 |
2 使用日志服务查看API日志
2.1 配置日志服务
目前有2种配置方式：1）通过日志服务页面的“日志审计”进行API网关日志同步。这种方式所有region的日志都会集中到日志审计这个project下。API网关上不需要做额外的配置。2）通过sls页面做API网关数据接入的方式配置，这种方式每个region都需要做一次同步配置。下面将分别介绍这两种配置方法。
政务云和金融云的SLS日志同步，目前仅支持用第1种方法配置。
2.1.1 通过日志审计方式配置
1）打开sls日志审计服务配置页面，选择中心region，根据自己需要选择对应的region就行，后续所有的API网关日志都会投递到这个region。
然后选择以上2种方式之一做授权，根据文档提示操作。文示例选择“手动授权”。
授权完成后，根据本页面的中心project下的apigateway_log查看API网关的调用日志。
2.1.2 在API网关控制台配置
1）请确保您已经开通了日志服务，然后在SLS控制台选择对应的region，创建Project 和 Logstore。以华东1 region为例。
2）配置API网关数据接入，选择API网关产品
然后一直“下一步”，至成功为止。
2.2 查看日志
您可以登录日志服务控制台查看日志，根据日志服务的查询语法，在线检索调用日志。
2.3 查看预定义报表
API网关为了方便用户统计查询，在系统中预置了一些报表统计。包括：请求量大小、成功率、错误率、延时情况、调用API的APP数量，错误情况统计、TOP 分组、TOP API、Top 延迟等等。您可以进入配置后的SLS的logstore，点开logstore详情->可视化仪表盘查看预定义报表 gateway_log_apigateway访问日志。
2.4 自定义查询报表
您可以根据自身业务需要自定义查询报表，请参照定义方法：创建仪表盘。
