参数 是否必填 参数类型 说明 示例 下级对象 regionID 是 String ctyun资源池ID 81f7728662dd11ec810800155d307d5b status 是 Integer 本参数表示状态。取值范围： 0：正在告警。 1：告警历史。 根据以上范围取值。 0 resourceGroupID 否 String 资源分组ID。 3c9362ccbd9555c68b5f66b4b712dcfb searchKey 否 String 本参数表示搜索关键词。取值范围： alarmRuleID：告警规则ID，精确查询。 name：告警规则名称，模糊查询。 根据以上范围取值。 name searchValue 否 String 配合searchKey使用，对应的值 83bd75379e065a45a3b5f4b13a7e81ea service 否 Array of Strings 本参数表示告警服务。取值范围： ecs：云主机。 evs：云硬盘。 pms：物理机。 ... 云监控服务，具体服务参见 ['ecs', 'evs'] startTime 否 Integer 查询状态为告警历史（参数status1）时的起始时间戳， 默认值：24小时前时间戳，startTime和endTime需同时传或同时不传 1667815639 endTime 否 Integer 查询状态为告警历史（参数status1）时的结束时间戳，默认值：当前时间戳， 配合startTime一起使用 1667817639

接口功能介绍 导出指定条件的告警历史，导出格式为csv文件。 接口约束 regionID（资源池）存在，searchKey（搜索关键词）满足参数说明范围。 URI POST /v4/monitor/exportalerthistory 路径参数 无 Query参数 无 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 regionID 是 String ctyun资源池ID 81f7728662dd11ec810800155d307d5b status 是 Integer 本参数表示状态。取值范围： 0：正在告警。 1：告警历史。 根据以上范围取值。 0 resourceGroupID 否 String 资源分组ID。 3c9362ccbd9555c68b5f66b4b712dcfb searchKey 否 String 本参数表示搜索关键词。取值范围： alarmRuleID：告警规则ID，精确查询。 name：告警规则名称，模糊查询。 根据以上范围取值。 name searchValue 否 String 配合searchKey使用，对应的值 83bd75379e065a45a3b5f4b13a7e81ea service 否 Array of Strings 本参数表示告警服务。取值范围： ecs：云主机。 evs：云硬盘。 pms：物理机。 ... 云监控服务，具体服务参见云监控：查询服务维度及监控项 ['ecs', 'evs'] startTime 否 Integer 查询状态为告警历史（参数status1）时的起始时间戳， 默认值：24小时前时间戳，startTime和endTime需同时传或同时不传 1667815639 endTime 否 Integer 查询状态为告警历史（参数status1）时的结束时间戳，默认值：当前时间戳， 配合startTime一起使用 1667817639

本节主要介绍如何使用API批量查询采集的日志。 此操作用来批量查询采集的日志。 请求语法 plaintext GET /rest/v1/system/logcollect?filterfilter HTTP/1.1 Date: date Host: ip:port Authorization: authorization 请求参数 参数 类型 描述 是否必须 filter String 查询的过滤条件。 支持的查询条件为： status：日志采集的状态。 Processing：日志采集中。 Succeeded：采集成功。 PartiallySucceeded：部分采集成功。 Failed：采集失败。 logTypes：采集日志的类型 Config：配置相关的日志。 System：系统相关的日志。 Data：数据处理相关的日志（仅集群版支持）。 Coordination：内部协调服务相关的日志（仅集群版支持）。 否 响应结果 名称 类型 描述 logs Array of log 日志列表信息，详见“表1 响应参数log说明”。 message String 收集失败或者部分收集成功的原因，如果收集成功，则不会返回此项。 表1 响应参数log说明 名称 类型 描述 id String 日志ID。 startTime Long HBlock日志采集的起始时间。 endTime Long HBlock日志采集的结束时间。 servers Array of String HBlock日志采集的服务器ID。 logTypes Array of logType 采集的HBlock日志类型： Config：配置相关的日志。 System：系统相关的日志。 Data：数据处理相关的日志。 Coordination：内部协调服务相关的日志（仅集群版支持）。 file String 日志文件存储路径及名称。 status Enum 日志采集的状态： Processing：日志采集中。 Succeeded：采集成功。 PartiallySucceeded：部分采集成功。 Failed：采集失败。 size Long 采集到的日志文件大小，单位是bytes。 createTime Long 日志采集请求的创建时间。

云点播配置回调有哪些途径。 云点播配置回调有哪些途径？ 云点播支持以下回调方式： 全局回调； 实例回调； SDK/API回调。 详情可以查看【点播模式】【回调通知】和【点播模式API】【提交转码任务】。

HTTP鉴权有什么作用。 HTTP鉴权有什么作用？ HTTP鉴权是在回调过程增加特殊HTTP头，供回调地址提供方进行校验（防止非云点播服务调用该接口，造成安全问题）。具体是否校验可由用户自行判断。请注意接收回调的鉴权需要遵循云点播的鉴权规则，详情可查看【点播模式】【回调通知】。

回调发送失败怎么办? 回调发送失败怎么办？ HTTP/HTTPS回调超时时间默认为10秒。若连接或发送回调失败，将会按照5s、10s、20s、30s、40s、50s、60s、80s、120s、150s、180s的间隔进行11轮重试，每轮重试将最多尝试3次，频次为1s/次。若经过以上重试仍无法回调成功，后续将不再进行新的重试。若在任意一轮尝试中回调成功，则后续将不再进行新的重试。

6. 请求匹配模式 匹配全部：所有 HTTP 请求都会被校验。 白名单模式：配置的path不执行jwt校验，path支持通配符，但只能出现在末尾，例如 /user 或 /user/。 黑名单模式：配置的path才执行jwt校验，path支持通配符，但只能出现在末尾，例如 /user 或 /user/。

响应示例 plaintext HTTP/1.1 200 OK xhblockrequestid: 83e8981108e948719fb64f7a977fede5 Connection: keepalive ContentLength: 400 Date: Wed, 07 Aug 2024 05: 57: 41 GMT ContentType: application/json;charsetutf8 Server: HBlock { "data": { "id": "54dfd39212fc476dba61f761c08d8a8a", "startTime": 1722915993000, "endTime": 1723009593754, "servers": [ "hblock1", "hblock2", "hblock3", "hblock4" ], "logTypes": [ "Config" ], "file": "192.168.0.192:/mnt/storage01/CTYUNHBlockPlus3.7.0x64/collectedlogs/hblocklogs54dfd39212fc476dba61f761c08d8a8a2024080603463320240807054633.zip", "status": "Succeeded", "size": 104534, "createTime": 1723009566777 } }

参数 类型 描述 是否必须 startTime String HBlock日志采集的起始时间。 取值：unix时间戳（UTC），精确到毫秒。默认值为HBlock日志采集结束时间2小时之前的时间点。 注意 HBlock日志采集的起始时间必须早于HBlocks日志采集的结束时间。 如果HBlock日志采集的起始时间早于HBlock初始化时间，则HBlock初始化时间为日志采集起始时间。 如果修改系统时间，可能导致日志文件的最后修改时间出现波动甚至错误。 否 endTime String HBlock日志采集的结束时间。 取值：unix时间戳（UTC），精确到毫秒。默认值为当前时间。 注意 HBlock日志采集的起始时间必须早于HBlocks日志采集的结束时间。 HBlock日志采集的结束时间必须晚于HBlock初始化时间。 日志文件的最后修改时间大于结束时间时，如果存在多个大于结束时间的同类型日志，则HBlock日志采集时间值最小的那个日志文件。 否 servers Array of String 要采集HBlock日志的服务器ID。 取值：可以填写多个服务器ID，以英文逗号（,）隔开。默认采集所有服务器。 否 logTypes Array of logType 采集的日志类型 取值： Config：配置相关的日志。 System：系统相关的日志。 Data：数据处理相关的日志（仅集群版支持）。 Coordination：内部协调服务相关的日志（仅集群版支持）。 默认采集所有类型的日志。 否 outputDirectory String HBlock日志采集后存放的目录，为绝对路径。 取值：如果不指定，默认存放在被请求服务器的HBlock安装目录下。以collectedlogs/hblocklogs idyyyyMMddHHmmssyyyyMMddHHmmss .zip命名，其中： id：本次日志请求的唯一标识符。 yyyyMMddHHmmss ：日志采集的起始时间和结束时间，UTC+0时间。 否

HTTP status 错误码 错误信息 描述 400 CanNotConnectToServer Can not connect to the server IP [: port ]. 无法连接服务器。 400 ExceedMaxValue Value value at 'number' failed to satisfy constraint: Argument must be less than or equal to value . 超过最大值。 400 ExceedThreshold The number of operation cannot exceed value. 超出了系统允许的最大个数，无法执行该操作。 400 InsufficientServerSpace This method is not allowed because the free space of directory must be greater than or equal to value for server serverId[, serverId...] . 存储空间不足。 400 InvalidDirectory The argument must be a directory specified with an absolute path. 输出路径必须是带有绝对路径的目录。 400 InvalidEnumValue Value value at ' argument ' failed to satisfy constraint: Argument must satisfy enum value set: [ value1, value2 ... ] 枚举参数不合法。 400 InvalidPositiveInteger Value value at ' number ' failed to satisfy constraint: Argument must be positive integer. 取值必须为正整数。 400 InvalidTime The end time must be later than the start time. 结束时间必须晚于开始时间。 400 InvalidTimeFormat Value value at ' argument ' failed to satisfy constraint: Argument must conform to Format format. 时间格式不合法。 400 StandaloneModeNotAllowed ' operation ' is not supported by standalone mode of HBlock. 单机版本HBlock不支持该操作。 400 TooLargeFile The file is too large. It is recommended to narrow the query range. 日志文件过大，建议缩小查询范围。 403 PermissionDenied Failed to action because user has no permission. 权限不足，无法执行该操作。 404 NoSuchLog The log with ID ID does not exist. 日志文件不存在。 409 InvalidLogStatus The status of log collection task with ID ID is ' status ', the request is invalid. 日志状态冲突，无法执行该操作。

本节主要介绍如何使用API删除所有的采集日志。 此操作用来删除所有的采集日志。 请求语法 plaintext DELETE /rest/v1/system/logcollect HTTP/1.1 Date: date Host: ip:port Authorization: authorization 请求示例 删除所有的采集日志。 plaintext DELETE /rest/v1/system/logcollect HTTP/1.1 Date: Mon, 08 Aug 2022 09:01:57 GMT Authorization: HBlock userName:signature Host:192.168.0.121:1443 响应示例 plaintext HTTP/1.1 204 No Content xhblockrequestid: d5e2973621064ed7b2e846b3874535d3 Connection: keepalive Date: Mon, 8 Aug 2022 09:02:00 GMT Server: HBlock

参数 类型 描述 是否必须 id String 日志ID。 是

参数 描述 id LOGID 日志ID。如果不指定，则删除HBlock采集的所有日志。

参数 描述 starttime STARTTIME HBlock日志采集的起始时间。格式为 yyyyMMdd HH:mm:ss ，默认值为HBlock日志采集结束时间2小时之前的时间点。 注意 HBlock日志采集的起始时间必须早于HBlock日志采集的结束时间。 如果HBlock日志采集的起始时间早于HBlock初始化时间，则HBlock初始化时间为日志采集起始时间。 如果修改系统时间，可能导致日志文件的最后修改时间出现波动甚至错误。 endtime ENDTIME HBlock 日志采集的结束时间。格式为 yyyyMMdd HH:mm:ss ，默认值为当前时间。 注意 HBlock日志采集的起始时间必须早于HBlock日志采集的结束时间。 HBlock日志采集的结束时间必须晚于HBlock初始化时间。 日志文件的最后修改时间大于结束时间时，如果存在多个大于结束时间的同类型日志，则HBlock日志采集时间值最小的那个日志文件。 o DIERECTORY 或 out DIERECTORY HBlock日志采集后存放的目录，为绝对路径。默认存放在被请求服务器的HBlock安装目录下，以collectedlogs/hblocklogs idyyyyMMddHHmmssyyyyMMddHHmmss .zip命名： id ：本次日志请求的唯一标识符。 yyyyMMddHHmmss :日志采集的起始时间和结束时间，UTC+0时间。 server SERVERID &<1n> 日志采集的服务器ID，默认采集所有服务器的HBlock日志。可以采集1到n个服务器的日志，n为集群中服务器的数量。 type LOGTYPE 采集的HBlock日志类型： Config：配置相关的日志。 System：系统相关的日志。 Data：数据处理相关的日志（仅集群版支持）。 Coordination：内部协调服务相关的日志（仅集群版支持）。 默认采集所有类型的日志。

约束条件 添加域名时配置错误将导致无法成功获取Web访问者请求的真实IP地址。 常规情况下，XForwardedFor字段中，第一个IP就是客户端真实IP，当IPV6地址长度超过XForwardedFor字段长度限制时，将读取不到IP地址；另外，nat64下，ELB是IPv4的监听器，也读不到ipv6地址。 通过WAF直接获取客户端真实IP 网站接入WAF后，WAF作为一个反向代理部署于客户端和服务器之间，实现网站安全防护。 在WAF中开启了代理，按以下顺序获取源IP： 1. 优先取“upstream”中配置的源IP头列表，即在域名的基本信息页面配置的“IP标记”，具体的操作请参见配置攻击惩罚的流量标识。如果未取到，执行[]( d1e7205)。 2. 取config中配置的源IP头列表“cdnsrcip”字段对应的值，未取到，执行[]( d1e7213)。 3. 取“xrealip”字段的值，未取到，执行[]( d1e7221)。 4. 取“xforwardedfor”字段左边开始第一个公网IP，未取到，执行[]( d1e7229)。 5. 取WAF看到的TCP连接IP，“remoteaddr”字段对应的值。 说明 如果想以TCP连接IP作为客户端IP，“IP标记”应配置为“remoteaddr”。 在WAF中未开启代理，直接取“remoteip”字段的值为真实IP。 下面为您介绍如何通过XForwardedFor和XRealIP变量获取客户端真实IP地址的方法： WAF使用XForwardedFor的方式获取客户端的真实IP地址。 WAF将“真实的客户端IP”放在HTTP头部的“XForwardedFor”字段，格式如下： 说明 当使用此方式获取客户端真实IP时，获取的第一个地址就是客户端真实IP。 各种语言通过调用SDK接口获取XForwardedFor字段的方式： ASP： plaintext Request.ServerVariables("HTTPXFORWARDEDFOR") ASP.NET(C

本文主要介绍关系数据库MySQL版的操作记录。 注意 仅II类型资源池支持该功能，具体支持情况以控制台页面展示为准。更多资源池信息，请参见功能概览。 使用场景 操作记录用于记录用户对实例进行的操作，可用于追溯排查故障，包括操作相关的主账号或子账号、实例名称、操作类型和操作结果等信息。 操作步骤 1. 在天翼云官网首页的顶部菜单栏，选择产品 > 数据库 > 关系型数据库 > 关系数据库MySQL版 ，进入关系数据库MySQL产品页面。然后单击管理控制台 ，进入概览页面。 2. 在左侧导航栏，选择MySQL > 操作记录，进入实例操作记录列表页面。然后在顶部菜单栏，选择区域和项目。 3. 在操作记录列表中，查看操作相关信息。 您可以查看子账户级别的操作记录。 您可以在筛选框通过账号名、操作结果、操作类型和时间筛选目标操作记录。 说明 操作记录展示与实例相关的操作，针对操作记录是否显示实例名称说明如下： 如果有实例名称，则表示该操作是针对此实例执行的。 如果实例名称为空，则表示该操作为全局性操作，与具体实例无关，例如修改参数模板、创建新的参数模板等。

本章节为您介绍日志分析常用的监控指标 监控指标 释义 常见原因 建议阈值 处理建议 respcode：200 服务器已成功处理请求，返回了请求的数据。 初始化正常业务时，200状态码的告警监控阈值可以配置为90%，具体根据实际业务情况调整。 如果发现低于监控比例，需要分析比例下降的原因，例如是否因为其他错误状态码比例增加。 requesttime 客户端请求到返回结果的请求耗时，即从客户端WAF源站再从源站WAF客户端整个时长 按实际业务请求所需耗时，设置合适的超时告警监控阈值。 如果发现域名请求耗时较长，需要检查客户端WAF源站整体网络链路质量，并排查源站响应状态是否正常。 responsetime 请求回源时，源站返回数据的响应时间，即从WAF源站再从源站WAF的时间。 按实际业务请求所需耗时，设置合适的超时告警监控阈值。 如果发现域名请求耗时较长，需要检查客户端WAF源站整体网络链路质量，并排查源站响应状态是否正常。 status:403 WAF拦截状态码，由Web核心防护、BOT防护、CC防护、地域防护等所有防护模块产生的防护状态均为403 WAF安全策略拦截 通过全量日志分析拦截的规则、请求行为，判断是正常拦截还是误拦截。 status:404 服务器找不到请求的资源。 【客户端相关】 客户端输入错误（最常见） 前端/App代码问题 【服务端相关】 资源被删除或迁移 权限/状态导致逻辑404 短暂的系统异常 自动化扫描/攻击 初始化时，建议配置5%~10%的告警阈值比例，后续运营期间可以根据业务拦截情况灵活调整。 少量404（例如总请求量的0.1%以下）且集中在特定来源（爬虫/旧书签）通常无需紧急处理，但如果涉及核心业务流程或突增超过0.5%，建议按以下步骤排查。 检查最近一次代码/配置发布的时间点与404突增时间是否吻合。 查看404 URL是否有明显规律（如特定路径、特定参数值、特定来源页面）。 确认是否存在损坏的外部链接（如合作方网站跳转）。 验证Web服务器（如Nginx）和应用程序的404日志是否一致。 针对单个404 URL，使用 curl v 模拟请求，查看完整响应头。 status:499 客户端发起请求，服务端未返回数据，超过客户端设置的等待时间后，客户端主动断链，服务端返回给客户端该状态码。 【客户端相关】 客户端超时设置过短 用户行为 【服务端相关】 后端处理太慢（最常见） 【网络相关】 网络问题 【WAF相关】 WAF超时配置过短 初始化时，建议配置5%~10%的告警阈值比例，后续运营期间可以根据业务拦截情况灵活调整。 优先排查慢接口（SQL、下游调用、复杂计算），然后调整超时配置，同时关注非幂等请求的重复调用问题。少量偶发（<0.1%）可以接受，超过 1% 需要尽快优化。 status:500 服务器内部发生了预期外的错误，无法完成请求。简单说：代码报错了。 不是客户端的问题（请求本身可能是合法的） 不是网络问题 是后端代码运行时抛出了未捕获的异常（如空指针、数组越界、数据库连接失败、语法错误等） 少量 500 通常意味着存在 Bug，需要修复。 【服务器相关】 1.服务器代码异常（最常见） 2.数据库问题 3.依赖服务故障 4.内存/资源不足 5.配置错误 6.发布相关 初始化时，建议配置5%~10%的告警阈值比例，后续运营期间可以根据业务拦截情况灵活调整。 少量 500（比如单日个位数）如果确认是偶发的极端情况（比如某个特殊数据导致的空指针），建议记录并修复，不应存在预期内的 500。任何 500 都应该被当做一个可观测的 Bug 来处理。 status:502 WAF作为“前台”，向后端（“后台”）请求数据，但后台没有给出正确的 HTTP 响应。这通常意味着前后台之间的通道断了。一般由于回源网络质量变差、回源链路有访问控制拦截回源请求导致源站无响应。 【服务器相关】 1. 后端服务进程挂了（最常见） 2. 后端服务端口未监听 3. WAF到后端的连接失败 4. 超时（容易与 504 混淆） 5. 响应格式不合法，后端返回了一个 WAF 无法解析的响应（如不是标准的 HTTP 格式），响应的 ContentLength 与实际 body 长度不一致。 6.WAF回源配置中源站位置不可达 【WAF相关】 7.WAF keepalive超限 初始化时，建议配置5%~10%的告警阈值比例，后续运营期间可以根据业务拦截情况灵活调整。 建议检查回源网络链路、回源链路中间的访问控制策略、源站处理资源负载、数据库等情况。检查源站是否拦截了WAF回源IP的请求。少量偶发的 502（比如发布期间的几秒钟）可以接受，但持续性或高比例的 502 必须立即处理。 status:503 服务器暂时无法处理请求，通常是因为过载、正在维护或后端主动拒绝服务。 【服务器相关】 1. 服务过载（最常见） 2. 主动限流/熔断（设计行为） 3. 正在维护/部署 4. 配置错误 5. 资源耗尽（系统层面） 初始化时，建议配置5%~10%的告警阈值比例，后续运营期间可以根据业务拦截情况灵活调整。 少量 503 在高峰期或发布期间可以接受（如限流触发的正常拒绝），但如果核心接口持续返回 503，说明系统容量不足或配置有问题，需要扩容或优化。对于限流返回的 503，建议在响应头中添加 RetryAfter: 5 status:504 作为网关或代理的服务器（如 Nginx），在规定时间内没有从上游服务器（如应用服务器）收到响应。 【服务器相关】 1. 后端处理慢（最常见） 2. 超时配置过短 3. 后端资源瓶颈 4. 数据库问题 5. 依赖服务故障 6. 网络问题（少见，但可能） 初始化时，建议配置5%~10%的告警阈值比例，后续运营期间可以根据业务拦截情况灵活调整。 根据以下可能的原因进行排查： 检查WAF的回源IP网段是否有被拦截 服务器无法响应，负载过高。 源站丢弃请求没有reset。 协议通讯不成功。

触发消息 定时触发器会按照用户设定的时间通过POST请求触发用户函数，其body为如下结构体： { "time": "20241205T02:24:09Z", "name": "triggername", "data": "hello,trigger" } 注意事项 1. 定时触发器支持指定时区，如果Cron表达式未指定，则按UTC时间执行。例如，希望在北京时间早上9点触发，可以有以下两种设置方式： 1. 使用UTC时间运行：0 0 1 2. 使用北京时间运行：CRONTZAsia/Shanghai 0 0 9

触发器不能正常触发函数执行的主要原因是不满足触发规则，请您再次检查触发器的触发规则是否与预期效果一致。 若您确定触发器的规则无误并且依旧不能触发函数，请及时联系客服；提供您的天翼云账号ID、函数计算的函数名称以及相应的触发器等信息。

配置项 操作 示例 触发器类型 选择 云原生触发器。 云原生触发器 名称 填写自定义的触发器名称。 cgwtrigger 版本或别名 默认值为 LATEST ，支持选择任意函数版本或函数别名。 LATEST 网关实例 选择已创建的云原生网关实例。 域名 选择网关实例已关联的域名。 mydomain.com 匹配路径 匹配请求的path（不含query参数），当前支持前缀匹配和精确匹配。末尾使用''代表使用前缀匹配。 /my/path 请求方法 匹配请求中的HTTP方法，可多选，不选则匹配所有HTTP方法 优先级 当多个路由同时匹配一个请求时，路径匹配深度较大的路由优先；路径匹配相同的情况下，路由优先级高（数字大）的优先匹配。 0 请求头 匹配请求中的HTTP header。 请求参数 匹配请求中的HTTP query参数。 触发器启用状态 创建触发器后是否立即启用。默认选择开启，即创建触发器后立即启用触发器。 启用