tencentcloud-sdk-nodejs 4.0.691 → 4.0.693

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (114) hide show
  1. package/CHANGELOG.md +489 -0
  2. package/SERVICE_CHANGELOG.md +534 -206
  3. package/package.json +1 -1
  4. package/products.md +34 -34
  5. package/src/common/sdk_version.ts +1 -1
  6. package/src/services/apm/v20210622/apm_client.ts +17 -0
  7. package/src/services/apm/v20210622/apm_models.ts +187 -0
  8. package/src/services/asr/v20190614/asr_models.ts +5 -5
  9. package/src/services/cam/v20190116/cam_models.ts +1 -1
  10. package/src/services/car/v20220110/car_client.ts +28 -16
  11. package/src/services/car/v20220110/car_models.ts +24 -0
  12. package/src/services/cbs/v20170312/cbs_models.ts +5 -4
  13. package/src/services/cdb/v20170320/cdb_models.ts +11 -6
  14. package/src/services/cdn/v20180606/cdn_client.ts +21 -14
  15. package/src/services/cdn/v20180606/cdn_models.ts +19 -19
  16. package/src/services/clb/v20180317/clb_client.ts +61 -11
  17. package/src/services/clb/v20180317/clb_models.ts +259 -64
  18. package/src/services/cls/v20201016/cls_client.ts +680 -656
  19. package/src/services/cls/v20201016/cls_models.ts +80 -0
  20. package/src/services/cpdp/v20190820/cpdp_client.ts +1 -13
  21. package/src/services/cpdp/v20190820/cpdp_models.ts +35 -113
  22. package/src/services/cvm/v20170312/cvm_models.ts +2 -2
  23. package/src/services/cwp/v20180228/cwp_client.ts +52 -2
  24. package/src/services/cwp/v20180228/cwp_models.ts +343 -46
  25. package/src/services/cynosdb/v20190107/cynosdb_client.ts +1 -0
  26. package/src/services/cynosdb/v20190107/cynosdb_models.ts +81 -24
  27. package/src/services/dasb/v20191018/dasb_client.ts +12 -0
  28. package/src/services/dasb/v20191018/dasb_models.ts +33 -0
  29. package/src/services/ess/v20201111/ess_client.ts +25 -21
  30. package/src/services/ess/v20201111/ess_models.ts +255 -171
  31. package/src/services/essbasic/v20210526/essbasic_models.ts +12 -7
  32. package/src/services/iai/v20180301/iai_models.ts +3 -3
  33. package/src/services/iai/v20200303/iai_models.ts +3 -3
  34. package/src/services/iss/v20230517/iss_client.ts +21 -7
  35. package/src/services/iss/v20230517/iss_models.ts +47 -0
  36. package/src/services/lcic/v20220817/lcic_models.ts +1 -1
  37. package/src/services/mps/v20190612/mps_models.ts +16 -0
  38. package/src/services/ocr/v20181119/ocr_models.ts +9 -0
  39. package/src/services/organization/v20210331/organization_client.ts +18 -6
  40. package/src/services/organization/v20210331/organization_models.ts +20 -0
  41. package/src/services/tag/v20180813/tag_client.ts +4 -6
  42. package/src/services/tag/v20180813/tag_models.ts +60 -22
  43. package/src/services/thpc/v20230321/thpc_client.ts +5 -1
  44. package/src/services/thpc/v20230321/thpc_models.ts +119 -63
  45. package/src/services/trp/v20210515/trp_models.ts +60 -22
  46. package/src/services/trtc/v20190722/trtc_models.ts +5 -3
  47. package/src/services/waf/v20180125/waf_client.ts +20 -8
  48. package/src/services/waf/v20180125/waf_models.ts +122 -52
  49. package/tencentcloud/common/sdk_version.d.ts +1 -1
  50. package/tencentcloud/common/sdk_version.js +1 -1
  51. package/tencentcloud/services/apm/v20210622/apm_client.d.ts +5 -1
  52. package/tencentcloud/services/apm/v20210622/apm_client.js +6 -0
  53. package/tencentcloud/services/apm/v20210622/apm_models.d.ts +180 -0
  54. package/tencentcloud/services/asr/v20190614/asr_models.d.ts +5 -5
  55. package/tencentcloud/services/cam/v20190116/cam_models.d.ts +1 -1
  56. package/tencentcloud/services/car/v20220110/car_client.d.ts +11 -7
  57. package/tencentcloud/services/car/v20220110/car_client.js +15 -9
  58. package/tencentcloud/services/car/v20220110/car_models.d.ts +22 -0
  59. package/tencentcloud/services/cbs/v20170312/cbs_models.d.ts +5 -4
  60. package/tencentcloud/services/cdb/v20170320/cdb_models.d.ts +11 -6
  61. package/tencentcloud/services/cdn/v20180606/cdn_client.d.ts +14 -7
  62. package/tencentcloud/services/cdn/v20180606/cdn_client.js +14 -7
  63. package/tencentcloud/services/cdn/v20180606/cdn_models.d.ts +19 -19
  64. package/tencentcloud/services/clb/v20180317/clb_client.d.ts +19 -3
  65. package/tencentcloud/services/clb/v20180317/clb_client.js +27 -3
  66. package/tencentcloud/services/clb/v20180317/clb_models.d.ts +249 -64
  67. package/tencentcloud/services/cls/v20201016/cls_client.d.ts +334 -326
  68. package/tencentcloud/services/cls/v20201016/cls_client.js +420 -408
  69. package/tencentcloud/services/cls/v20201016/cls_models.d.ts +76 -0
  70. package/tencentcloud/services/cpdp/v20190820/cpdp_client.d.ts +1 -5
  71. package/tencentcloud/services/cpdp/v20190820/cpdp_client.js +0 -6
  72. package/tencentcloud/services/cpdp/v20190820/cpdp_models.d.ts +35 -111
  73. package/tencentcloud/services/cvm/v20170312/cvm_models.d.ts +2 -2
  74. package/tencentcloud/services/cwp/v20180228/cwp_client.d.ts +17 -1
  75. package/tencentcloud/services/cwp/v20180228/cwp_client.js +24 -0
  76. package/tencentcloud/services/cwp/v20180228/cwp_models.d.ts +333 -46
  77. package/tencentcloud/services/cynosdb/v20190107/cynosdb_models.d.ts +80 -24
  78. package/tencentcloud/services/dasb/v20191018/dasb_client.d.ts +5 -1
  79. package/tencentcloud/services/dasb/v20191018/dasb_client.js +6 -0
  80. package/tencentcloud/services/dasb/v20191018/dasb_models.d.ts +31 -0
  81. package/tencentcloud/services/ess/v20201111/ess_client.d.ts +25 -21
  82. package/tencentcloud/services/ess/v20201111/ess_client.js +25 -21
  83. package/tencentcloud/services/ess/v20201111/ess_models.d.ts +255 -171
  84. package/tencentcloud/services/essbasic/v20210526/essbasic_models.d.ts +12 -7
  85. package/tencentcloud/services/iai/v20180301/iai_models.d.ts +3 -3
  86. package/tencentcloud/services/iai/v20200303/iai_models.d.ts +3 -3
  87. package/tencentcloud/services/iss/v20230517/iss_client.d.ts +8 -3
  88. package/tencentcloud/services/iss/v20230517/iss_client.js +10 -3
  89. package/tencentcloud/services/iss/v20230517/iss_models.d.ts +44 -0
  90. package/tencentcloud/services/lcic/v20220817/lcic_models.d.ts +1 -1
  91. package/tencentcloud/services/mps/v20190612/mps_models.d.ts +16 -0
  92. package/tencentcloud/services/ocr/v20181119/ocr_models.d.ts +9 -0
  93. package/tencentcloud/services/organization/v20210331/organization_client.d.ts +7 -3
  94. package/tencentcloud/services/organization/v20210331/organization_client.js +9 -3
  95. package/tencentcloud/services/organization/v20210331/organization_models.d.ts +18 -0
  96. package/tencentcloud/services/tag/v20180813/tag_client.d.ts +0 -2
  97. package/tencentcloud/services/tag/v20180813/tag_client.js +0 -2
  98. package/tencentcloud/services/tag/v20180813/tag_models.d.ts +60 -22
  99. package/tencentcloud/services/thpc/v20230321/thpc_models.d.ts +115 -63
  100. package/tencentcloud/services/trp/v20210515/trp_models.d.ts +60 -22
  101. package/tencentcloud/services/trtc/v20190722/trtc_models.d.ts +5 -3
  102. package/tencentcloud/services/waf/v20180125/waf_client.d.ts +13 -9
  103. package/tencentcloud/services/waf/v20180125/waf_client.js +14 -8
  104. package/tencentcloud/services/waf/v20180125/waf_models.d.ts +120 -52
  105. package/test/apm.v20210622.test.js +10 -0
  106. package/test/car.v20220110.test.js +18 -8
  107. package/test/clb.v20180317.test.js +42 -2
  108. package/test/cls.v20201016.test.js +188 -168
  109. package/test/cpdp.v20190820.test.js +0 -10
  110. package/test/cwp.v20180228.test.js +40 -0
  111. package/test/dasb.v20191018.test.js +10 -0
  112. package/test/iss.v20230517.test.js +12 -2
  113. package/test/organization.v20210331.test.js +12 -2
  114. package/test/waf.v20180125.test.js +10 -0
@@ -1,6 +1,6 @@
1
1
  import { AbstractClient } from "../../../common/abstract_client";
2
2
  import { ClientConfig } from "../../../common/interface";
3
- import { UploadLogResponse, CreateAlarmResponse, DeleteAlarmNoticeResponse, DescribeLogHistogramRequest, DescribeLogContextRequest, DeleteShipperRequest, DeleteScheduledSqlRequest, DeleteLogsetResponse, DescribeCosRechargesResponse, DescribeShipperTasksResponse, CreateMachineGroupResponse, DescribeConfigMachineGroupsRequest, ModifyConfigExtraResponse, SearchCosRechargeInfoRequest, ModifyLogsetRequest, UploadLogRequest, CreateLogsetRequest, DescribeShippersRequest, CreateScheduledSqlResponse, DescribeDashboardsRequest, SearchLogResponse, DeleteTopicRequest, DescribePartitionsRequest, ModifyAlarmResponse, DescribeShipperTasksRequest, DescribeAlarmsRequest, MergePartitionRequest, DescribeShippersResponse, DescribeKafkaConsumerResponse, CreateConfigExtraResponse, ModifyShipperResponse, DeleteKafkaRechargeResponse, DescribeConfigExtrasResponse, ModifyDataTransformRequest, DescribeScheduledSqlInfoResponse, OpenKafkaConsumerResponse, DescribeIndexRequest, ModifyScheduledSqlResponse, DescribeConfigsResponse, DeleteMachineGroupInfoRequest, CreateLogsetResponse, DeleteMachineGroupResponse, DescribeCosRechargesRequest, CreateCosRechargeRequest, DescribeKafkaUserRequest, DeleteDataTransformResponse, DeleteConfigExtraResponse, ModifyConsumerRequest, CreateIndexResponse, DeleteConfigFromMachineGroupResponse, CreateConsumerResponse, ModifyMachineGroupResponse, DeleteMachineGroupRequest, DescribePartitionsResponse, DescribeConfigMachineGroupsResponse, ModifyAlarmRequest, DescribeTopicsResponse, ModifyAlarmNoticeRequest, CreateAlarmRequest, DeleteExportResponse, DeleteScheduledSqlResponse, RetryShipperTaskResponse, SplitPartitionRequest, DescribeMachineGroupConfigsResponse, CheckRechargeKafkaServerRequest, DescribeLogHistogramResponse, CloseKafkaConsumerResponse, DescribeMachineGroupsRequest, DescribeConsumerRequest, CreateIndexRequest, DescribeLogsetsResponse, DeleteConsumerResponse, DescribeTopicsRequest, GetAlarmLogResponse, CreateTopicRequest, DescribeExportsRequest, CreateKafkaRechargeResponse, ModifyScheduledSqlRequest, DeleteConfigResponse, ModifyIndexResponse, DeleteConsumerRequest, DeleteIndexRequest, DescribeConsumerResponse, ModifyConsumerResponse, DescribeAlertRecordHistoryRequest, DescribeConfigsRequest, DeleteConfigRequest, CloseKafkaConsumerRequest, CreateExportRequest, DescribeAlarmNoticesResponse, DeleteDataTransformRequest, DescribeMachineGroupsResponse, DeleteConfigExtraRequest, ModifyConfigRequest, AddMachineGroupInfoRequest, DescribeKafkaRechargesRequest, PreviewKafkaRechargeResponse, CreateShipperRequest, CreateTopicResponse, DeleteAlarmResponse, DescribeAlarmsResponse, CreateAlarmNoticeResponse, ModifyTopicResponse, CreateConfigRequest, CreateShipperResponse, DescribeKafkaRechargesResponse, DeleteIndexResponse, ModifyIndexRequest, DescribeDataTransformInfoRequest, DeleteShipperResponse, ModifyKafkaConsumerRequest, DescribeLogContextResponse, DeleteExportRequest, PreviewKafkaRechargeRequest, SplitPartitionResponse, CreateDataTransformResponse, ModifyShipperRequest, CreateKafkaRechargeRequest, DeleteKafkaRechargeRequest, CreateConfigExtraRequest, CreateConsumerRequest, ModifyConfigResponse, OpenKafkaConsumerRequest, ModifyKafkaRechargeResponse, ModifyAlarmNoticeResponse, DescribeMachinesResponse, ModifyCosRechargeResponse, DescribeDashboardsResponse, ApplyConfigToMachineGroupResponse, DeleteAlarmRequest, CreateConfigResponse, ModifyKafkaConsumerResponse, DeleteConfigFromMachineGroupRequest, SearchCosRechargeInfoResponse, CreateCosRechargeResponse, DescribeAlertRecordHistoryResponse, AddMachineGroupInfoResponse, ModifyMachineGroupRequest, DescribeAlarmNoticesRequest, ModifyTopicRequest, DescribeMachinesRequest, DeleteAlarmNoticeRequest, DescribeScheduledSqlInfoRequest, DeleteLogsetRequest, ModifyLogsetResponse, SearchLogRequest, CreateMachineGroupRequest, DescribeExportsResponse, ApplyConfigToMachineGroupRequest, GetAlarmLogRequest, DescribeConfigExtrasRequest, CreateAlarmNoticeRequest, DescribeIndexResponse, DescribeMachineGroupConfigsRequest, ModifyConfigExtraRequest, ModifyKafkaRechargeRequest, CreateDataTransformRequest, DeleteMachineGroupInfoResponse, CheckRechargeKafkaServerResponse, ModifyCosRechargeRequest, DescribeLogsetsRequest, DescribeKafkaUserResponse, DeleteTopicResponse, DescribeKafkaConsumerRequest, ModifyDataTransformResponse, DescribeDataTransformInfoResponse, RetryShipperTaskRequest, CreateExportResponse, MergePartitionResponse, CreateScheduledSqlRequest } from "./cls_models";
3
+ import { UploadLogResponse, CreateAlarmResponse, DeleteAlarmNoticeResponse, DescribeLogHistogramRequest, DescribeLogContextRequest, DeleteShipperRequest, DeleteScheduledSqlRequest, DeleteLogsetResponse, DescribeCosRechargesResponse, DescribeShipperTasksResponse, CreateMachineGroupResponse, DescribeConfigMachineGroupsRequest, ModifyConfigExtraResponse, SearchCosRechargeInfoRequest, ModifyLogsetRequest, UploadLogRequest, CreateLogsetRequest, DescribeShippersRequest, CreateScheduledSqlResponse, DescribeDashboardsRequest, QueryMetricRequest, SearchLogResponse, DeleteTopicRequest, DescribePartitionsRequest, ModifyAlarmResponse, DescribeShipperTasksRequest, DescribeAlarmsRequest, MergePartitionRequest, DescribeShippersResponse, DescribeKafkaConsumerResponse, CreateConfigExtraResponse, ModifyShipperResponse, DeleteKafkaRechargeResponse, DescribeConfigExtrasResponse, ModifyDataTransformRequest, DescribeScheduledSqlInfoResponse, OpenKafkaConsumerResponse, DescribeIndexRequest, ModifyScheduledSqlResponse, DescribeConfigsResponse, DeleteMachineGroupInfoRequest, CreateLogsetResponse, DeleteMachineGroupResponse, DescribeCosRechargesRequest, CreateCosRechargeRequest, DescribeKafkaUserRequest, DeleteDataTransformResponse, DeleteConfigExtraResponse, ModifyConsumerRequest, CreateIndexResponse, DeleteConfigFromMachineGroupResponse, CreateConsumerResponse, ModifyMachineGroupResponse, DeleteMachineGroupRequest, QueryMetricResponse, DescribePartitionsResponse, DescribeConfigMachineGroupsResponse, ModifyAlarmRequest, DescribeTopicsResponse, ModifyAlarmNoticeRequest, CreateAlarmRequest, DeleteExportResponse, DeleteScheduledSqlResponse, RetryShipperTaskResponse, SplitPartitionRequest, DescribeMachineGroupConfigsResponse, CheckRechargeKafkaServerRequest, DescribeLogHistogramResponse, CloseKafkaConsumerResponse, DescribeMachineGroupsRequest, DescribeConsumerRequest, CreateIndexRequest, DescribeLogsetsResponse, DeleteConsumerResponse, DescribeTopicsRequest, GetAlarmLogResponse, CreateTopicRequest, DescribeExportsRequest, CreateKafkaRechargeResponse, ModifyScheduledSqlRequest, DeleteConfigResponse, ModifyIndexResponse, DeleteConsumerRequest, QueryRangeMetricResponse, DeleteIndexRequest, DescribeConsumerResponse, ModifyConsumerResponse, DescribeAlertRecordHistoryRequest, DescribeConfigsRequest, DeleteConfigRequest, CloseKafkaConsumerRequest, CreateExportRequest, QueryRangeMetricRequest, DescribeAlarmNoticesResponse, DeleteDataTransformRequest, DescribeMachineGroupsResponse, DeleteConfigExtraRequest, ModifyConfigRequest, AddMachineGroupInfoRequest, DescribeKafkaRechargesRequest, PreviewKafkaRechargeResponse, CreateShipperRequest, CreateTopicResponse, DeleteAlarmResponse, DescribeAlarmsResponse, CreateAlarmNoticeResponse, ModifyTopicResponse, CreateConfigRequest, CreateShipperResponse, DescribeKafkaRechargesResponse, DeleteIndexResponse, ModifyIndexRequest, DescribeDataTransformInfoRequest, DeleteShipperResponse, ModifyKafkaConsumerRequest, DescribeLogContextResponse, DeleteExportRequest, PreviewKafkaRechargeRequest, SplitPartitionResponse, CreateDataTransformResponse, ModifyShipperRequest, CreateKafkaRechargeRequest, DeleteKafkaRechargeRequest, CreateConfigExtraRequest, CreateConsumerRequest, ModifyConfigResponse, OpenKafkaConsumerRequest, ModifyKafkaRechargeResponse, ModifyAlarmNoticeResponse, DescribeMachinesResponse, ModifyCosRechargeResponse, DescribeDashboardsResponse, ApplyConfigToMachineGroupResponse, DeleteAlarmRequest, CreateConfigResponse, ModifyKafkaConsumerResponse, DeleteConfigFromMachineGroupRequest, SearchCosRechargeInfoResponse, CreateCosRechargeResponse, DescribeAlertRecordHistoryResponse, AddMachineGroupInfoResponse, ModifyMachineGroupRequest, DescribeAlarmNoticesRequest, ModifyTopicRequest, DescribeMachinesRequest, DeleteAlarmNoticeRequest, DescribeScheduledSqlInfoRequest, DeleteLogsetRequest, ModifyLogsetResponse, SearchLogRequest, CreateMachineGroupRequest, DescribeExportsResponse, ApplyConfigToMachineGroupRequest, GetAlarmLogRequest, DescribeConfigExtrasRequest, CreateAlarmNoticeRequest, DescribeIndexResponse, DescribeMachineGroupConfigsRequest, ModifyConfigExtraRequest, ModifyKafkaRechargeRequest, CreateDataTransformRequest, DeleteMachineGroupInfoResponse, CheckRechargeKafkaServerResponse, ModifyCosRechargeRequest, DescribeLogsetsRequest, DescribeKafkaUserResponse, DeleteTopicResponse, DescribeKafkaConsumerRequest, ModifyDataTransformResponse, DescribeDataTransformInfoResponse, RetryShipperTaskRequest, CreateExportResponse, MergePartitionResponse, CreateScheduledSqlRequest } from "./cls_models";
4
4
  /**
5
5
  * cls client
6
6
  * @class
@@ -8,500 +8,508 @@ import { UploadLogResponse, CreateAlarmResponse, DeleteAlarmNoticeResponse, Desc
8
8
  export declare class Client extends AbstractClient {
9
9
  constructor(clientConfig: ClientConfig);
10
10
  /**
11
- * 创建机器组
11
+ * 修改Kafka协议消费信息
12
12
  */
13
- CreateMachineGroup(req: CreateMachineGroupRequest, cb?: (error: string, rep: CreateMachineGroupResponse) => void): Promise<CreateMachineGroupResponse>;
13
+ ModifyKafkaConsumer(req: ModifyKafkaConsumerRequest, cb?: (error: string, rep: ModifyKafkaConsumerResponse) => void): Promise<ModifyKafkaConsumerResponse>;
14
14
  /**
15
- * 用于删除机器组信息
15
+ * 本接口用于创建Kafka数据订阅任务
16
16
  */
17
- DeleteMachineGroupInfo(req: DeleteMachineGroupInfoRequest, cb?: (error: string, rep: DeleteMachineGroupInfoResponse) => void): Promise<DeleteMachineGroupInfoResponse>;
17
+ CreateKafkaRecharge(req: CreateKafkaRechargeRequest, cb?: (error: string, rep: CreateKafkaRechargeResponse) => void): Promise<CreateKafkaRechargeResponse>;
18
18
  /**
19
- * 本接口用于获取告警任务历史
19
+ * 本接口用于获取日志下载任务列表
20
20
  */
21
- GetAlarmLog(req: GetAlarmLogRequest, cb?: (error: string, rep: GetAlarmLogResponse) => void): Promise<GetAlarmLogResponse>;
21
+ DescribeExports(req: DescribeExportsRequest, cb?: (error: string, rep: DescribeExportsResponse) => void): Promise<DescribeExportsResponse>;
22
22
  /**
23
- * ## 提示
24
- 为了保障您日志数据的可靠性以及更高效地使用日志服务,建议您使用CLS优化后的接口[上传结构化日志](https://cloud.tencent.com/document/product/614/16873)。
25
-
26
- 同时我们给此接口专门优化定制了多个语言版本的SDK供您选择,SDK提供统一的异步发送、资源控制、自动重试、优雅关闭、感知上报等功能,使上报日志功能更完善,详情请参考[SDK采集](https://cloud.tencent.com/document/product/614/67157)。
27
-
28
- 同时云API上传日志接口也支持同步上传日志数据,如果您选择继续使用此接口请参考下文。
29
-
30
- ## 功能描述
31
-
32
- 本接口用于将日志写入到指定的日志主题。
33
-
34
- 日志服务提供以下两种模式:
35
-
36
- #### 负载均衡模式
37
-
38
- 系统根据当前日志主题下所有可读写的分区,遵循负载均衡原则自动分配写入的目标分区。该模式适合消费不保序的场景。
39
-
40
- #### 哈希路由模式
41
-
42
- 系统根据携带的哈希值(X-CLS-HashKey)将数据写入到符合范围要求的目标分区。例如,可以将某个日志源端通过 hashkey 与某个主题分区强绑定,这样可以保证数据在该分区上写入和消费是严格保序的。
43
-
44
-
45
-
46
- #### 输入参数(pb二进制流,位于body中)
47
-
48
- | 字段名 | 类型 | 位置 | 必须 | 含义 |
49
- | ------------ | ------- | ---- | ---- | ------------------------------------------------------------ |
50
- | logGroupList | message | pb | 是 | logGroup 列表,封装好的日志组列表内容,建议 logGroup 数量不要超过5个 |
51
-
52
- LogGroup 说明:
53
-
54
- | 字段名 | 是否必选 | 含义 |
55
- | ----------- | -------- | ------------------------------------------------------------ |
56
- | logs | 是 | 日志数组,表示有多个 Log 组成的集合,一个 Log 表示一条日志,一个 LogGroup 中 Log 个数不能超过10000 |
57
- | contextFlow | 否 | LogGroup 的唯一ID,需要使用上下文功能时传入。格式:"{上下文ID}-{LogGroupID}"。<br>上下文ID:唯一标识一个上下文(连续滚动的一系列日志文件,或者是需要保序的一系列日志),16进制64位整型字符串。<br>LogGroupID:连续递增的一串整型,16进制64位整型字符串。样例:"102700A66102516A-59F59"。 |
58
- | filename | 否 | 日志文件名 |
59
- | source | 否 | 日志来源,一般使用机器 IP 作为标识 |
60
- | logTags | 否 | 日志的标签列表 |
61
-
62
- Log 说明:
63
-
64
- | 字段名 | 是否必选 | 含义 |
65
- | -------- | -------- | ------------------------------------------------------------ |
66
- | time | 是 | 日志时间(Unix 格式时间戳),支持秒、毫秒,建议采用毫秒 |
67
- | contents | 否 | key-value 格式的日志内容,表示一条日志里的多个 key-value 组合 |
68
-
69
- Content 说明:
70
-
71
- | 字段名 | 是否必选 | 含义 |
72
- | ------ | -------- | ------------------------------------------------------------ |
73
- | key | 是 | 单条日志里某个字段组的 key 值,不能以`_`开头 |
74
- | value | 是 | 单条日志某个字段组的 value 值,单条日志 value 不能超过1MB,LogGroup 中所有 value 总和不能超过5MB |
75
-
76
- LogTag 说明:
77
-
78
- | 字段名 | 是否必选 | 含义 |
79
- | ------ | -------- | -------------------------------- |
80
- | key | 是 | 自定义的标签 key |
81
- | value | 是 | 自定义的标签 key 对应的 value 值 |
82
-
83
- ## PB 编译示例
84
-
85
- 本示例将说明如何使用官方 protoc 编译工具将 PB 描述文件 编译生成为 C++ 语言可调用的上传日志接口。
86
-
87
- > ?目前 protoc 官方支持 Java、C++、Python 等语言的编译,详情请参见 [protoc](https://github.com/protocolbuffers/protobuf)。
88
-
89
- #### 1. 安装 Protocol Buffer
90
-
91
- 下载 [Protocol Buffer](https://main.qcloudimg.com/raw/d7810aaf8b3073fbbc9d4049c21532aa/protobuf-2.6.1.tar.gz) ,解压并安装。示例版本为 protobuf 2.6.1,环境为 Centos 7.3 系统。 解压`protobuf-2.6.1.tar.gz`压缩包至`/usr/local`目录并进入该目录,执行命令如下:
92
-
93
- ```
94
- tar -zxvf protobuf-2.6.1.tar.gz -C /usr/local/ && cd /usr/local/protobuf-2.6.1
95
- ```
96
-
97
- 开始编译和安装,配置环境变量,执行命令如下:
98
-
99
- ```
100
- [root@VM_0_8_centos protobuf-2.6.1]# ./configure
101
- [root@VM_0_8_centos protobuf-2.6.1]# make && make install
102
- [root@VM_0_8_centos protobuf-2.6.1]# export PATH=$PATH:/usr/local/protobuf-2.6.1/bin
103
- ```
104
-
105
- 编译成功后,您可以使用以下命令查看版本:
106
-
107
- ```
108
- [root@VM_0_8_centos protobuf-2.6.1]# protoc --version
109
- liprotoc 2.6.1
110
- ```
111
-
112
- #### 2. 创建 PB 描述文件
113
-
114
- PB 描述文件是通信双方约定的数据交换格式,上传日志时须将规定的协议格式编译成对应语言版本的调用接口,然后添加到工程代码里,详情请参见 [protoc](https://github.com/protocolbuffers/protobuf) 。
115
-
116
- 以日志服务所规定的 PB 数据格式内容为准, 在本地创建 PB 消息描述文件 cls.proto。
117
-
118
- > !PB 描述文件内容不可更改,且文件名须以`.proto`结尾。
119
-
120
- cls.proto 内容(PB 描述文件)如下:
121
-
122
- ```
123
- package cls;
124
-
125
- message Log
126
- {
127
- message Content
128
- {
129
- required string key = 1; // 每组字段的 key
130
- required string value = 2; // 每组字段的 value
131
- }
132
- required int64 time = 1; // 时间戳,UNIX时间格式
133
- repeated Content contents = 2; // 一条日志里的多个kv组合
134
- }
135
-
136
- message LogTag
137
- {
138
- required string key = 1;
139
- required string value = 2;
140
- }
141
-
142
- message LogGroup
143
- {
144
- repeated Log logs = 1; // 多条日志合成的日志数组
145
- optional string contextFlow = 2; // 目前暂无效用
146
- optional string filename = 3; // 日志文件名
147
- optional string source = 4; // 日志来源,一般使用机器IP
148
- repeated LogTag logTags = 5;
149
- }
150
-
151
- message LogGroupList
152
- {
153
- repeated LogGroup logGroupList = 1; // 日志组列表
154
- }
155
- ```
156
-
157
- #### 3. 编译生成
158
-
159
- 此例中,使用 proto 编译器生成 C++ 语言的文件,在 cls.proto 文件的同一目录下,执行如下编译命令:
160
-
161
- ```
162
- protoc --cpp_out=./ ./cls.proto
163
- ```
164
-
165
- > ?`--cpp_out=./`表示编译成 cpp 格式并输出当前目录下,`./cls.proto`表示位于当前目录下的 cls.proto 描述文件。
166
-
167
- 编译成功后,会输出对应语言的代码文件。此例会生成 cls.pb.h 头文件和 [cls.pb.cc](http://cls.pb.cc) 代码实现文件,如下所示:
168
-
169
- ```
170
- [root@VM_0_8_centos protobuf-2.6.1]# protoc --cpp_out=./ ./cls.proto
171
- [root@VM_0_8_centos protobuf-2.6.1]# ls
172
- cls.pb.cc cls.pb.h cls.proto
173
- ```
174
-
175
- #### 4. 调用
176
-
177
- 将生成的 cls.pb.h 头文件引入代码中,调用接口进行数据格式封装。
23
+ * 本接口用于创建索引
178
24
  */
179
- UploadLog(req: UploadLogRequest, cb?: (error: string, rep: UploadLogResponse) => void): Promise<UploadLogResponse>;
25
+ CreateIndex(req: CreateIndexRequest, cb?: (error: string, rep: CreateIndexResponse) => void): Promise<CreateIndexResponse>;
180
26
  /**
181
- * 本接口用于创建投递任务
27
+ * 修改现有的投递规则,客户如果使用此接口,需要自行处理CLS对指定bucket的写权限。
182
28
  */
183
- CreateConsumer(req: CreateConsumerRequest, cb?: (error: string, rep: CreateConsumerResponse) => void): Promise<CreateConsumerResponse>;
29
+ ModifyShipper(req: ModifyShipperRequest, cb?: (error: string, rep: ModifyShipperResponse) => void): Promise<ModifyShipperResponse>;
184
30
  /**
185
- * 本接口用于获取kafka用户信息
31
+ * 获取采集规则配置
186
32
  */
187
- DescribeKafkaUser(req: DescribeKafkaUserRequest, cb?: (error: string, rep: DescribeKafkaUserResponse) => void): Promise<DescribeKafkaUserResponse>;
33
+ DescribeConfigs(req: DescribeConfigsRequest, cb?: (error: string, rep: DescribeConfigsResponse) => void): Promise<DescribeConfigsResponse>;
188
34
  /**
189
- * 本接口用于修改日志主题。
35
+ * 本接口用于删除日志集。
190
36
  */
191
- ModifyTopic(req: ModifyTopicRequest, cb?: (error: string, rep: ModifyTopicResponse) => void): Promise<ModifyTopicResponse>;
37
+ DeleteLogset(req: DeleteLogsetRequest, cb?: (error: string, rep: DeleteLogsetResponse) => void): Promise<DeleteLogsetResponse>;
192
38
  /**
193
- * 本接口用于预览cos导入信息
39
+ * 删除应用到机器组的采集配置
194
40
  */
195
- SearchCosRechargeInfo(req: SearchCosRechargeInfoRequest, cb?: (error: string, rep: SearchCosRechargeInfoResponse) => void): Promise<SearchCosRechargeInfoResponse>;
41
+ DeleteConfigFromMachineGroup(req: DeleteConfigFromMachineGroupRequest, cb?: (error: string, rep: DeleteConfigFromMachineGroupResponse) => void): Promise<DeleteConfigFromMachineGroupResponse>;
196
42
  /**
197
- * 本接口用于获取cos导入配置
43
+ * 本接口用于删除数据加工任务
198
44
  */
199
- DescribeCosRecharges(req: DescribeCosRechargesRequest, cb?: (error: string, rep: DescribeCosRechargesResponse) => void): Promise<DescribeCosRechargesResponse>;
45
+ DeleteDataTransform(req: DeleteDataTransformRequest, cb?: (error: string, rep: DeleteDataTransformResponse) => void): Promise<DeleteDataTransformResponse>;
200
46
  /**
201
- * 本接口用于获取日志集信息列表。
47
+ * 本接口用于创建日志集,返回新创建的日志集的 ID。
202
48
  */
203
- DescribeLogsets(req: DescribeLogsetsRequest, cb?: (error: string, rep: DescribeLogsetsResponse) => void): Promise<DescribeLogsetsResponse>;
49
+ CreateLogset(req: CreateLogsetRequest, cb?: (error: string, rep: CreateLogsetResponse) => void): Promise<CreateLogsetResponse>;
204
50
  /**
205
- * 本接口用于修改Kafka数据订阅任务
51
+ * 本接口用于创建日志主题。
206
52
  */
207
- ModifyKafkaRecharge(req: ModifyKafkaRechargeRequest, cb?: (error: string, rep: ModifyKafkaRechargeResponse) => void): Promise<ModifyKafkaRechargeResponse>;
53
+ CreateTopic(req: CreateTopicRequest, cb?: (error: string, rep: CreateTopicResponse) => void): Promise<CreateTopicResponse>;
208
54
  /**
209
- * 本接口用于获取日志下载任务列表
55
+ * 该接口用于删除通知渠道组
210
56
  */
211
- DescribeExports(req: DescribeExportsRequest, cb?: (error: string, rep: DescribeExportsResponse) => void): Promise<DescribeExportsResponse>;
57
+ DeleteAlarmNotice(req: DeleteAlarmNoticeRequest, cb?: (error: string, rep: DeleteAlarmNoticeResponse) => void): Promise<DeleteAlarmNoticeResponse>;
212
58
  /**
213
- * 本接口用于修改索引配置,该接口除受默认接口请求频率限制外,针对单个日志主题,并发数不能超过1,即同一时间同一个日志主题只能有一个正在执行的索引配置修改操作。
214
-
59
+ * 获取告警历史,例如今天未恢复的告警
215
60
  */
216
- ModifyIndex(req: ModifyIndexRequest, cb?: (error: string, rep: ModifyIndexResponse) => void): Promise<ModifyIndexResponse>;
61
+ DescribeAlertRecordHistory(req: DescribeAlertRecordHistoryRequest, cb?: (error: string, rep: DescribeAlertRecordHistoryResponse) => void): Promise<DescribeAlertRecordHistoryResponse>;
217
62
  /**
218
- * 新建投递到COS的任务,【!!!注意】使用此接口,需要检查是否配置了投递COS的角色和权限。如果没有配置,请参考文档投递权限查看和配置https://cloud.tencent.com/document/product/614/71623。
63
+ * 本接口用于删除Kafka数据订阅任务
219
64
  */
220
- CreateShipper(req: CreateShipperRequest, cb?: (error: string, rep: CreateShipperResponse) => void): Promise<CreateShipperResponse>;
65
+ DeleteKafkaRecharge(req: DeleteKafkaRechargeRequest, cb?: (error: string, rep: DeleteKafkaRechargeResponse) => void): Promise<DeleteKafkaRechargeResponse>;
221
66
  /**
222
- * 本接口用于获取索引配置信息
67
+ * 创建采集规则配置
223
68
  */
224
- DescribeIndex(req: DescribeIndexRequest, cb?: (error: string, rep: DescribeIndexResponse) => void): Promise<DescribeIndexResponse>;
69
+ CreateConfig(req: CreateConfigRequest, cb?: (error: string, rep: CreateConfigResponse) => void): Promise<CreateConfigResponse>;
225
70
  /**
226
- * 本接口用于获取主题分区列表。
71
+ * 查询指定时刻指标的最新值
227
72
  */
228
- DescribePartitions(req: DescribePartitionsRequest, cb?: (error: string, rep: DescribePartitionsResponse) => void): Promise<DescribePartitionsResponse>;
73
+ QueryMetric(req: QueryMetricRequest, cb?: (error: string, rep: QueryMetricResponse) => void): Promise<QueryMetricResponse>;
229
74
  /**
230
- * 本接口用于创建索引
75
+ * 本接口用于获取日志主题列表,支持分页
231
76
  */
232
- CreateIndex(req: CreateIndexRequest, cb?: (error: string, rep: CreateIndexResponse) => void): Promise<CreateIndexResponse>;
77
+ DescribeTopics(req: DescribeTopicsRequest, cb?: (error: string, rep: DescribeTopicsResponse) => void): Promise<DescribeTopicsResponse>;
233
78
  /**
234
- * 本接口用于获取定时SQL分析任务列表
79
+ * 本接口用于创建cos导入任务
235
80
  */
236
- DescribeScheduledSqlInfo(req: DescribeScheduledSqlInfoRequest, cb?: (error: string, rep: DescribeScheduledSqlInfoResponse) => void): Promise<DescribeScheduledSqlInfoResponse>;
81
+ CreateCosRecharge(req: CreateCosRechargeRequest, cb?: (error: string, rep: CreateCosRechargeResponse) => void): Promise<CreateCosRechargeResponse>;
237
82
  /**
238
- * 删除采集规则配置
83
+ * 本接口用于合并一个读写态的主题分区,合并时指定一个主题分区 ID,日志服务会自动合并范围右相邻的分区。
239
84
  */
240
- DeleteConfig(req: DeleteConfigRequest, cb?: (error: string, rep: DeleteConfigResponse) => void): Promise<DeleteConfigResponse>;
85
+ MergePartition(req: MergePartitionRequest, cb?: (error: string, rep: MergePartitionResponse) => void): Promise<MergePartitionResponse>;
241
86
  /**
242
- * 本接口用于获取特殊采集配置,特殊采集配置应用于自建K8S环境的采集Agent
87
+ * 本接口用于删除定时SQL分析任务
243
88
  */
244
- DescribeConfigExtras(req: DescribeConfigExtrasRequest, cb?: (error: string, rep: DescribeConfigExtrasResponse) => void): Promise<DescribeConfigExtrasResponse>;
89
+ DeleteScheduledSql(req: DeleteScheduledSqlRequest, cb?: (error: string, rep: DeleteScheduledSqlResponse) => void): Promise<DeleteScheduledSqlResponse>;
245
90
  /**
246
- * 本接口用于校验Kafka服务集群是否可以正常访问
91
+ * 本接口仅创建下载任务,任务返回的下载地址,请用户调用DescribeExports查看任务列表。其中有下载地址CosPath参数。参考文档https://cloud.tencent.com/document/product/614/56449
247
92
  */
248
- CheckRechargeKafkaServer(req: CheckRechargeKafkaServerRequest, cb?: (error: string, rep: CheckRechargeKafkaServerResponse) => void): Promise<CheckRechargeKafkaServerResponse>;
93
+ CreateExport(req: CreateExportRequest, cb?: (error: string, rep: CreateExportResponse) => void): Promise<CreateExportResponse>;
249
94
  /**
250
- * 本接口用于修改投递任务
95
+ * 关闭Kafka协议消费
251
96
  */
252
- ModifyConsumer(req: ModifyConsumerRequest, cb?: (error: string, rep: ModifyConsumerResponse) => void): Promise<ModifyConsumerResponse>;
97
+ CloseKafkaConsumer(req: CloseKafkaConsumerRequest, cb?: (error: string, rep: CloseKafkaConsumerResponse) => void): Promise<CloseKafkaConsumerResponse>;
253
98
  /**
254
- * 本接口用于创建Kafka数据订阅任务
99
+ * 本接口用于修改索引配置,该接口除受默认接口请求频率限制外,针对单个日志主题,并发数不能超过1,即同一时间同一个日志主题只能有一个正在执行的索引配置修改操作。
100
+
255
101
  */
256
- CreateKafkaRecharge(req: CreateKafkaRechargeRequest, cb?: (error: string, rep: CreateKafkaRechargeResponse) => void): Promise<CreateKafkaRechargeResponse>;
102
+ ModifyIndex(req: ModifyIndexRequest, cb?: (error: string, rep: ModifyIndexResponse) => void): Promise<ModifyIndexResponse>;
257
103
  /**
258
- * 该接口用于创建通知渠道组。
104
+ * 本接口用于获取索引配置信息
259
105
  */
260
- CreateAlarmNotice(req: CreateAlarmNoticeRequest, cb?: (error: string, rep: CreateAlarmNoticeResponse) => void): Promise<CreateAlarmNoticeResponse>;
106
+ DescribeIndex(req: DescribeIndexRequest, cb?: (error: string, rep: DescribeIndexResponse) => void): Promise<DescribeIndexResponse>;
261
107
  /**
262
- * 本接口用于删除投递配置
108
+ * 新建投递到COS的任务,【!!!注意】使用此接口,需要检查是否配置了投递COS的角色和权限。如果没有配置,请参考文档投递权限查看和配置https://cloud.tencent.com/document/product/614/71623。
263
109
  */
264
- DeleteConsumer(req: DeleteConsumerRequest, cb?: (error: string, rep: DeleteConsumerResponse) => void): Promise<DeleteConsumerResponse>;
110
+ CreateShipper(req: CreateShipperRequest, cb?: (error: string, rep: CreateShipperResponse) => void): Promise<CreateShipperResponse>;
265
111
  /**
266
- * 本接口用于修改告警策略。需要至少修改一项有效内容。
112
+ * 本接口用于修改投递任务
267
113
  */
268
- ModifyAlarm(req: ModifyAlarmRequest, cb?: (error: string, rep: ModifyAlarmResponse) => void): Promise<ModifyAlarmResponse>;
114
+ ModifyConsumer(req: ModifyConsumerRequest, cb?: (error: string, rep: ModifyConsumerResponse) => void): Promise<ModifyConsumerResponse>;
269
115
  /**
270
- * 删除机器组
116
+ * 本接口用于删除投递配置
271
117
  */
272
- DeleteMachineGroup(req: DeleteMachineGroupRequest, cb?: (error: string, rep: DeleteMachineGroupResponse) => void): Promise<DeleteMachineGroupResponse>;
118
+ DeleteConsumer(req: DeleteConsumerRequest, cb?: (error: string, rep: DeleteConsumerResponse) => void): Promise<DeleteConsumerResponse>;
273
119
  /**
274
- * 重试失败的投递任务
120
+ * 删除机器组
275
121
  */
276
- RetryShipperTask(req: RetryShipperTaskRequest, cb?: (error: string, rep: RetryShipperTaskResponse) => void): Promise<RetryShipperTaskResponse>;
122
+ DeleteMachineGroup(req: DeleteMachineGroupRequest, cb?: (error: string, rep: DeleteMachineGroupResponse) => void): Promise<DeleteMachineGroupResponse>;
277
123
  /**
278
- * 本接口用于获取日志主题列表,支持分页
124
+ * 本接口用于获取Kafka数据订阅任务
279
125
  */
280
- DescribeTopics(req: DescribeTopicsRequest, cb?: (error: string, rep: DescribeTopicsResponse) => void): Promise<DescribeTopicsResponse>;
126
+ DescribeKafkaRecharges(req: DescribeKafkaRechargesRequest, cb?: (error: string, rep: DescribeKafkaRechargesResponse) => void): Promise<DescribeKafkaRechargesResponse>;
281
127
  /**
282
- * 本接口用于删除日志集。
128
+ * 本接口用于获取告警策略列表。
283
129
  */
284
- DeleteLogset(req: DeleteLogsetRequest, cb?: (error: string, rep: DeleteLogsetResponse) => void): Promise<DeleteLogsetResponse>;
130
+ DescribeAlarms(req: DescribeAlarmsRequest, cb?: (error: string, rep: DescribeAlarmsResponse) => void): Promise<DescribeAlarmsResponse>;
285
131
  /**
286
- * 获取投递到COS的任务配置信息
132
+ * 本接口用于获取cos导入配置
287
133
  */
288
- DescribeShippers(req: DescribeShippersRequest, cb?: (error: string, rep: DescribeShippersResponse) => void): Promise<DescribeShippersResponse>;
134
+ DescribeCosRecharges(req: DescribeCosRechargesRequest, cb?: (error: string, rep: DescribeCosRechargesResponse) => void): Promise<DescribeCosRechargesResponse>;
289
135
  /**
290
- * 修改机器组
136
+ * 应用采集配置到指定机器组
291
137
  */
292
- ModifyMachineGroup(req: ModifyMachineGroupRequest, cb?: (error: string, rep: ModifyMachineGroupResponse) => void): Promise<ModifyMachineGroupResponse>;
138
+ ApplyConfigToMachineGroup(req: ApplyConfigToMachineGroupRequest, cb?: (error: string, rep: ApplyConfigToMachineGroupResponse) => void): Promise<ApplyConfigToMachineGroupResponse>;
293
139
  /**
294
- * 删除应用到机器组的采集配置
140
+ * 本接口用于构建日志数量直方图
295
141
  */
296
- DeleteConfigFromMachineGroup(req: DeleteConfigFromMachineGroupRequest, cb?: (error: string, rep: DeleteConfigFromMachineGroupResponse) => void): Promise<DeleteConfigFromMachineGroupResponse>;
142
+ DescribeLogHistogram(req: DescribeLogHistogramRequest, cb?: (error: string, rep: DescribeLogHistogramResponse) => void): Promise<DescribeLogHistogramResponse>;
297
143
  /**
298
- * 本接口用于删除数据加工任务
144
+ * 该接口用于修改通知渠道组
299
145
  */
300
- DeleteDataTransform(req: DeleteDataTransformRequest, cb?: (error: string, rep: DeleteDataTransformResponse) => void): Promise<DeleteDataTransformResponse>;
146
+ ModifyAlarmNotice(req: ModifyAlarmNoticeRequest, cb?: (error: string, rep: ModifyAlarmNoticeResponse) => void): Promise<ModifyAlarmNoticeResponse>;
301
147
  /**
302
- * 本接口用于创建日志集,返回新创建的日志集的 ID。
148
+ * 打开Kafka协议消费功能
303
149
  */
304
- CreateLogset(req: CreateLogsetRequest, cb?: (error: string, rep: CreateLogsetResponse) => void): Promise<CreateLogsetResponse>;
150
+ OpenKafkaConsumer(req: OpenKafkaConsumerRequest, cb?: (error: string, rep: OpenKafkaConsumerResponse) => void): Promise<OpenKafkaConsumerResponse>;
305
151
  /**
306
- * 本接口用于获取Kafka数据订阅任务
152
+ * 获取投递任务列表
307
153
  */
308
- DescribeKafkaRecharges(req: DescribeKafkaRechargesRequest, cb?: (error: string, rep: DescribeKafkaRechargesResponse) => void): Promise<DescribeKafkaRechargesResponse>;
154
+ DescribeShipperTasks(req: DescribeShipperTasksRequest, cb?: (error: string, rep: DescribeShipperTasksResponse) => void): Promise<DescribeShipperTasksResponse>;
309
155
  /**
310
- * 本接口用于创建数据加工任务。
156
+ * 本接口用于删除日志主题的索引配置,删除索引配置后将无法检索和查询采集到的日志。
311
157
  */
312
- CreateDataTransform(req: CreateDataTransformRequest, cb?: (error: string, rep: CreateDataTransformResponse) => void): Promise<CreateDataTransformResponse>;
158
+ DeleteIndex(req: DeleteIndexRequest, cb?: (error: string, rep: DeleteIndexResponse) => void): Promise<DeleteIndexResponse>;
313
159
  /**
314
- * 用于添加机器组信息
160
+ * 获取Kafka协议消费信息
315
161
  */
316
- AddMachineGroupInfo(req: AddMachineGroupInfoRequest, cb?: (error: string, rep: AddMachineGroupInfoResponse) => void): Promise<AddMachineGroupInfoResponse>;
162
+ DescribeKafkaConsumer(req: DescribeKafkaConsumerRequest, cb?: (error: string, rep: DescribeKafkaConsumerResponse) => void): Promise<DescribeKafkaConsumerResponse>;
317
163
  /**
318
- * 本接口用于获取数据加工任务列表基本信息
164
+ * 本接口用于预览Kafka数据订阅任务客户日志信息
319
165
  */
320
- DescribeDataTransformInfo(req: DescribeDataTransformInfoRequest, cb?: (error: string, rep: DescribeDataTransformInfoResponse) => void): Promise<DescribeDataTransformInfoResponse>;
166
+ PreviewKafkaRecharge(req: PreviewKafkaRechargeRequest, cb?: (error: string, rep: PreviewKafkaRechargeResponse) => void): Promise<PreviewKafkaRechargeResponse>;
321
167
  /**
322
- * 该接口用于获取通知渠道组列表
168
+ * 本接口用于修改特殊采集配置任务,特殊采集配置应用于自建K8S环境的采集Agent
323
169
  */
324
- DescribeAlarmNotices(req: DescribeAlarmNoticesRequest, cb?: (error: string, rep: DescribeAlarmNoticesResponse) => void): Promise<DescribeAlarmNoticesResponse>;
170
+ ModifyConfigExtra(req: ModifyConfigExtraRequest, cb?: (error: string, rep: ModifyConfigExtraResponse) => void): Promise<ModifyConfigExtraResponse>;
325
171
  /**
326
- * 本接口用于创建日志主题。
172
+ * 本接口用于创建特殊采集配置任务,特殊采集配置应用于自建K8S环境的采集Agent
327
173
  */
328
- CreateTopic(req: CreateTopicRequest, cb?: (error: string, rep: CreateTopicResponse) => void): Promise<CreateTopicResponse>;
174
+ CreateConfigExtra(req: CreateConfigExtraRequest, cb?: (error: string, rep: CreateConfigExtraResponse) => void): Promise<CreateConfigExtraResponse>;
329
175
  /**
330
- * 应用采集配置到指定机器组
176
+ * 本接口用于修改定时SQL分析任务
331
177
  */
332
- ApplyConfigToMachineGroup(req: ApplyConfigToMachineGroupRequest, cb?: (error: string, rep: ApplyConfigToMachineGroupResponse) => void): Promise<ApplyConfigToMachineGroupResponse>;
178
+ ModifyScheduledSql(req: ModifyScheduledSqlRequest, cb?: (error: string, rep: ModifyScheduledSqlResponse) => void): Promise<ModifyScheduledSqlResponse>;
333
179
  /**
334
- * 本接口用于删除特殊采集规则配置,特殊采集配置应用于自建K8S环境的采集Agent
180
+ * 创建机器组
335
181
  */
336
- DeleteConfigExtra(req: DeleteConfigExtraRequest, cb?: (error: string, rep: DeleteConfigExtraResponse) => void): Promise<DeleteConfigExtraResponse>;
182
+ CreateMachineGroup(req: CreateMachineGroupRequest, cb?: (error: string, rep: CreateMachineGroupResponse) => void): Promise<CreateMachineGroupResponse>;
337
183
  /**
338
- * 本接口用于修改cos导入任务
184
+ * 用于删除机器组信息
339
185
  */
340
- ModifyCosRecharge(req: ModifyCosRechargeRequest, cb?: (error: string, rep: ModifyCosRechargeResponse) => void): Promise<ModifyCosRechargeResponse>;
186
+ DeleteMachineGroupInfo(req: DeleteMachineGroupInfoRequest, cb?: (error: string, rep: DeleteMachineGroupInfoResponse) => void): Promise<DeleteMachineGroupInfoResponse>;
341
187
  /**
342
- * 本接口用于分裂主题分区
188
+ * 本接口用于获取告警任务历史
343
189
  */
344
- SplitPartition(req: SplitPartitionRequest, cb?: (error: string, rep: SplitPartitionResponse) => void): Promise<SplitPartitionResponse>;
190
+ GetAlarmLog(req: GetAlarmLogRequest, cb?: (error: string, rep: GetAlarmLogResponse) => void): Promise<GetAlarmLogResponse>;
345
191
  /**
346
- * 该接口用于删除通知渠道组
192
+ * 本接口用于获取日志集信息列表。
347
193
  */
348
- DeleteAlarmNotice(req: DeleteAlarmNoticeRequest, cb?: (error: string, rep: DeleteAlarmNoticeResponse) => void): Promise<DeleteAlarmNoticeResponse>;
194
+ DescribeLogsets(req: DescribeLogsetsRequest, cb?: (error: string, rep: DescribeLogsetsResponse) => void): Promise<DescribeLogsetsResponse>;
349
195
  /**
350
- * 本接口用于获取仪表盘
196
+ * 本接口用于预览cos导入信息
351
197
  */
352
- DescribeDashboards(req: DescribeDashboardsRequest, cb?: (error: string, rep: DescribeDashboardsResponse) => void): Promise<DescribeDashboardsResponse>;
198
+ SearchCosRechargeInfo(req: SearchCosRechargeInfoRequest, cb?: (error: string, rep: SearchCosRechargeInfoResponse) => void): Promise<SearchCosRechargeInfoResponse>;
353
199
  /**
354
- * 本接口用于构建日志数量直方图
200
+ * 本接口用于修改Kafka数据订阅任务
355
201
  */
356
- DescribeLogHistogram(req: DescribeLogHistogramRequest, cb?: (error: string, rep: DescribeLogHistogramResponse) => void): Promise<DescribeLogHistogramResponse>;
202
+ ModifyKafkaRecharge(req: ModifyKafkaRechargeRequest, cb?: (error: string, rep: ModifyKafkaRechargeResponse) => void): Promise<ModifyKafkaRechargeResponse>;
357
203
  /**
358
- * 本接口用于检索分析日志, 该接口除受默认接口请求频率限制外,针对单个日志主题,查询并发数不能超过15。
359
-
360
- API返回数据包最大49MB,建议启用 gzip 压缩(HTTP Request Header Accept-Encoding:gzip)。
204
+ * 该接口用于创建通知渠道组。
361
205
  */
362
- SearchLog(req: SearchLogRequest, cb?: (error: string, rep: SearchLogResponse) => void): Promise<SearchLogResponse>;
206
+ CreateAlarmNotice(req: CreateAlarmNoticeRequest, cb?: (error: string, rep: CreateAlarmNoticeResponse) => void): Promise<CreateAlarmNoticeResponse>;
363
207
  /**
364
- * 本接口用于删除定时SQL分析任务
208
+ * 本接口用于创建数据加工任务。
365
209
  */
366
- DeleteScheduledSql(req: DeleteScheduledSqlRequest, cb?: (error: string, rep: DeleteScheduledSqlResponse) => void): Promise<DeleteScheduledSqlResponse>;
210
+ CreateDataTransform(req: CreateDataTransformRequest, cb?: (error: string, rep: CreateDataTransformResponse) => void): Promise<CreateDataTransformResponse>;
367
211
  /**
368
- * 获取制定机器组下的机器状态
212
+ * 用于添加机器组信息
369
213
  */
370
- DescribeMachines(req: DescribeMachinesRequest, cb?: (error: string, rep: DescribeMachinesResponse) => void): Promise<DescribeMachinesResponse>;
214
+ AddMachineGroupInfo(req: AddMachineGroupInfoRequest, cb?: (error: string, rep: AddMachineGroupInfoResponse) => void): Promise<AddMachineGroupInfoResponse>;
371
215
  /**
372
- * 打开Kafka协议消费功能
216
+ * 本接口用于获取数据加工任务列表基本信息
373
217
  */
374
- OpenKafkaConsumer(req: OpenKafkaConsumerRequest, cb?: (error: string, rep: OpenKafkaConsumerResponse) => void): Promise<OpenKafkaConsumerResponse>;
218
+ DescribeDataTransformInfo(req: DescribeDataTransformInfoRequest, cb?: (error: string, rep: DescribeDataTransformInfoResponse) => void): Promise<DescribeDataTransformInfoResponse>;
375
219
  /**
376
- * 修改采集规则配置
220
+ * 该接口用于获取通知渠道组列表
377
221
  */
378
- ModifyConfig(req: ModifyConfigRequest, cb?: (error: string, rep: ModifyConfigResponse) => void): Promise<ModifyConfigResponse>;
222
+ DescribeAlarmNotices(req: DescribeAlarmNoticesRequest, cb?: (error: string, rep: DescribeAlarmNoticesResponse) => void): Promise<DescribeAlarmNoticesResponse>;
379
223
  /**
380
- * 获取告警历史,例如今天未恢复的告警
224
+ * 本接口用于获取主题分区列表。
381
225
  */
382
- DescribeAlertRecordHistory(req: DescribeAlertRecordHistoryRequest, cb?: (error: string, rep: DescribeAlertRecordHistoryResponse) => void): Promise<DescribeAlertRecordHistoryResponse>;
226
+ DescribePartitions(req: DescribePartitionsRequest, cb?: (error: string, rep: DescribePartitionsResponse) => void): Promise<DescribePartitionsResponse>;
383
227
  /**
384
- * 本接口用于删除日志主题。
228
+ * 本接口用于删除特殊采集规则配置,特殊采集配置应用于自建K8S环境的采集Agent
385
229
  */
386
- DeleteTopic(req: DeleteTopicRequest, cb?: (error: string, rep: DeleteTopicResponse) => void): Promise<DeleteTopicResponse>;
230
+ DeleteConfigExtra(req: DeleteConfigExtraRequest, cb?: (error: string, rep: DeleteConfigExtraResponse) => void): Promise<DeleteConfigExtraResponse>;
387
231
  /**
388
- * 获取投递任务列表
232
+ * 本接口用于删除告警策略。
389
233
  */
390
- DescribeShipperTasks(req: DescribeShipperTasksRequest, cb?: (error: string, rep: DescribeShipperTasksResponse) => void): Promise<DescribeShipperTasksResponse>;
234
+ DeleteAlarm(req: DeleteAlarmRequest, cb?: (error: string, rep: DeleteAlarmResponse) => void): Promise<DeleteAlarmResponse>;
391
235
  /**
392
- * 本接口用于删除Kafka数据订阅任务
236
+ * 删除投递COS任务
393
237
  */
394
- DeleteKafkaRecharge(req: DeleteKafkaRechargeRequest, cb?: (error: string, rep: DeleteKafkaRechargeResponse) => void): Promise<DeleteKafkaRechargeResponse>;
238
+ DeleteShipper(req: DeleteShipperRequest, cb?: (error: string, rep: DeleteShipperResponse) => void): Promise<DeleteShipperResponse>;
395
239
  /**
396
- * 创建采集规则配置
240
+ * 查询指定时间范围内指标的变化趋势
397
241
  */
398
- CreateConfig(req: CreateConfigRequest, cb?: (error: string, rep: CreateConfigResponse) => void): Promise<CreateConfigResponse>;
242
+ QueryRangeMetric(req: QueryRangeMetricRequest, cb?: (error: string, rep: QueryRangeMetricResponse) => void): Promise<QueryRangeMetricResponse>;
399
243
  /**
400
- * 获取机器组绑定的采集规则配置
244
+ * 获取采集规则配置所绑定的机器组
401
245
  */
402
- DescribeMachineGroupConfigs(req: DescribeMachineGroupConfigsRequest, cb?: (error: string, rep: DescribeMachineGroupConfigsResponse) => void): Promise<DescribeMachineGroupConfigsResponse>;
246
+ DescribeConfigMachineGroups(req: DescribeConfigMachineGroupsRequest, cb?: (error: string, rep: DescribeConfigMachineGroupsResponse) => void): Promise<DescribeConfigMachineGroupsResponse>;
403
247
  /**
404
- * 修改Kafka协议消费信息
248
+ * 本接口用于删除日志下载任务
405
249
  */
406
- ModifyKafkaConsumer(req: ModifyKafkaConsumerRequest, cb?: (error: string, rep: ModifyKafkaConsumerResponse) => void): Promise<ModifyKafkaConsumerResponse>;
250
+ DeleteExport(req: DeleteExportRequest, cb?: (error: string, rep: DeleteExportResponse) => void): Promise<DeleteExportResponse>;
407
251
  /**
408
- * 删除投递COS任务
252
+ * 本接口用于分裂主题分区
409
253
  */
410
- DeleteShipper(req: DeleteShipperRequest, cb?: (error: string, rep: DeleteShipperResponse) => void): Promise<DeleteShipperResponse>;
254
+ SplitPartition(req: SplitPartitionRequest, cb?: (error: string, rep: SplitPartitionResponse) => void): Promise<SplitPartitionResponse>;
411
255
  /**
412
- * 本接口用于删除日志主题的索引配置,删除索引配置后将无法检索和查询采集到的日志。
256
+ * 获取机器组信息列表
413
257
  */
414
- DeleteIndex(req: DeleteIndexRequest, cb?: (error: string, rep: DeleteIndexResponse) => void): Promise<DeleteIndexResponse>;
258
+ DescribeMachineGroups(req: DescribeMachineGroupsRequest, cb?: (error: string, rep: DescribeMachineGroupsResponse) => void): Promise<DescribeMachineGroupsResponse>;
415
259
  /**
416
- * 本接口用于修改数据加工任务
260
+ * 本接口用于创建投递任务
417
261
  */
418
- ModifyDataTransform(req: ModifyDataTransformRequest, cb?: (error: string, rep: ModifyDataTransformResponse) => void): Promise<ModifyDataTransformResponse>;
262
+ CreateConsumer(req: CreateConsumerRequest, cb?: (error: string, rep: CreateConsumerResponse) => void): Promise<CreateConsumerResponse>;
419
263
  /**
420
- * 修改现有的投递规则,客户如果使用此接口,需要自行处理CLS对指定bucket的写权限。
264
+ * 本接口用于获取kafka用户信息
421
265
  */
422
- ModifyShipper(req: ModifyShipperRequest, cb?: (error: string, rep: ModifyShipperResponse) => void): Promise<ModifyShipperResponse>;
266
+ DescribeKafkaUser(req: DescribeKafkaUserRequest, cb?: (error: string, rep: DescribeKafkaUserResponse) => void): Promise<DescribeKafkaUserResponse>;
423
267
  /**
424
- * 本接口用于删除告警策略。
268
+ * 本接口用于修改日志主题。
425
269
  */
426
- DeleteAlarm(req: DeleteAlarmRequest, cb?: (error: string, rep: DeleteAlarmResponse) => void): Promise<DeleteAlarmResponse>;
270
+ ModifyTopic(req: ModifyTopicRequest, cb?: (error: string, rep: ModifyTopicResponse) => void): Promise<ModifyTopicResponse>;
427
271
  /**
428
- * 获取Kafka协议消费信息
272
+ * 修改机器组
429
273
  */
430
- DescribeKafkaConsumer(req: DescribeKafkaConsumerRequest, cb?: (error: string, rep: DescribeKafkaConsumerResponse) => void): Promise<DescribeKafkaConsumerResponse>;
274
+ ModifyMachineGroup(req: ModifyMachineGroupRequest, cb?: (error: string, rep: ModifyMachineGroupResponse) => void): Promise<ModifyMachineGroupResponse>;
431
275
  /**
432
- * 本接口用于搜索日志上下文附近的内容
276
+ * 本接口用于获取定时SQL分析任务列表
433
277
  */
434
- DescribeLogContext(req: DescribeLogContextRequest, cb?: (error: string, rep: DescribeLogContextResponse) => void): Promise<DescribeLogContextResponse>;
278
+ DescribeScheduledSqlInfo(req: DescribeScheduledSqlInfoRequest, cb?: (error: string, rep: DescribeScheduledSqlInfoResponse) => void): Promise<DescribeScheduledSqlInfoResponse>;
435
279
  /**
436
- * 本接口用于获取投递配置
280
+ * 删除采集规则配置
437
281
  */
438
- DescribeConsumer(req: DescribeConsumerRequest, cb?: (error: string, rep: DescribeConsumerResponse) => void): Promise<DescribeConsumerResponse>;
282
+ DeleteConfig(req: DeleteConfigRequest, cb?: (error: string, rep: DeleteConfigResponse) => void): Promise<DeleteConfigResponse>;
439
283
  /**
440
- * 该接口用于修改通知渠道组
284
+ * 本接口用于获取特殊采集配置,特殊采集配置应用于自建K8S环境的采集Agent
441
285
  */
442
- ModifyAlarmNotice(req: ModifyAlarmNoticeRequest, cb?: (error: string, rep: ModifyAlarmNoticeResponse) => void): Promise<ModifyAlarmNoticeResponse>;
286
+ DescribeConfigExtras(req: DescribeConfigExtrasRequest, cb?: (error: string, rep: DescribeConfigExtrasResponse) => void): Promise<DescribeConfigExtrasResponse>;
443
287
  /**
444
- * 获取采集规则配置
288
+ * 本接口用于校验Kafka服务集群是否可以正常访问
445
289
  */
446
- DescribeConfigs(req: DescribeConfigsRequest, cb?: (error: string, rep: DescribeConfigsResponse) => void): Promise<DescribeConfigsResponse>;
290
+ CheckRechargeKafkaServer(req: CheckRechargeKafkaServerRequest, cb?: (error: string, rep: CheckRechargeKafkaServerResponse) => void): Promise<CheckRechargeKafkaServerResponse>;
447
291
  /**
448
- * 本接口用于创建cos导入任务
292
+ * 本接口用于修改告警策略。需要至少修改一项有效内容。
449
293
  */
450
- CreateCosRecharge(req: CreateCosRechargeRequest, cb?: (error: string, rep: CreateCosRechargeResponse) => void): Promise<CreateCosRechargeResponse>;
294
+ ModifyAlarm(req: ModifyAlarmRequest, cb?: (error: string, rep: ModifyAlarmResponse) => void): Promise<ModifyAlarmResponse>;
451
295
  /**
452
- * 获取机器组信息列表
296
+ * 获取投递到COS的任务配置信息
453
297
  */
454
- DescribeMachineGroups(req: DescribeMachineGroupsRequest, cb?: (error: string, rep: DescribeMachineGroupsResponse) => void): Promise<DescribeMachineGroupsResponse>;
298
+ DescribeShippers(req: DescribeShippersRequest, cb?: (error: string, rep: DescribeShippersResponse) => void): Promise<DescribeShippersResponse>;
455
299
  /**
456
- * 本接口用于合并一个读写态的主题分区,合并时指定一个主题分区 ID,日志服务会自动合并范围右相邻的分区。
300
+ * 本接口用于获取仪表盘
457
301
  */
458
- MergePartition(req: MergePartitionRequest, cb?: (error: string, rep: MergePartitionResponse) => void): Promise<MergePartitionResponse>;
302
+ DescribeDashboards(req: DescribeDashboardsRequest, cb?: (error: string, rep: DescribeDashboardsResponse) => void): Promise<DescribeDashboardsResponse>;
459
303
  /**
460
- * 本接口用于创建特殊采集配置任务,特殊采集配置应用于自建K8S环境的采集Agent
304
+ * 本接口用于修改cos导入任务
461
305
  */
462
- CreateConfigExtra(req: CreateConfigExtraRequest, cb?: (error: string, rep: CreateConfigExtraResponse) => void): Promise<CreateConfigExtraResponse>;
306
+ ModifyCosRecharge(req: ModifyCosRechargeRequest, cb?: (error: string, rep: ModifyCosRechargeResponse) => void): Promise<ModifyCosRechargeResponse>;
463
307
  /**
464
- * 本接口用于预览Kafka数据订阅任务客户日志信息
308
+ * 修改采集规则配置
465
309
  */
466
- PreviewKafkaRecharge(req: PreviewKafkaRechargeRequest, cb?: (error: string, rep: PreviewKafkaRechargeResponse) => void): Promise<PreviewKafkaRechargeResponse>;
310
+ ModifyConfig(req: ModifyConfigRequest, cb?: (error: string, rep: ModifyConfigResponse) => void): Promise<ModifyConfigResponse>;
467
311
  /**
468
- * 获取采集规则配置所绑定的机器组
312
+ * ## 提示
313
+ 为了保障您日志数据的可靠性以及更高效地使用日志服务,建议您使用CLS优化后的接口[上传结构化日志](https://cloud.tencent.com/document/product/614/16873)。
314
+
315
+ 同时我们给此接口专门优化定制了多个语言版本的SDK供您选择,SDK提供统一的异步发送、资源控制、自动重试、优雅关闭、感知上报等功能,使上报日志功能更完善,详情请参考[SDK采集](https://cloud.tencent.com/document/product/614/67157)。
316
+
317
+ 同时云API上传日志接口也支持同步上传日志数据,如果您选择继续使用此接口请参考下文。
318
+
319
+ ## 功能描述
320
+
321
+ 本接口用于将日志写入到指定的日志主题。
322
+
323
+ 日志服务提供以下两种模式:
324
+
325
+ #### 负载均衡模式
326
+
327
+ 系统根据当前日志主题下所有可读写的分区,遵循负载均衡原则自动分配写入的目标分区。该模式适合消费不保序的场景。
328
+
329
+ #### 哈希路由模式
330
+
331
+ 系统根据携带的哈希值(X-CLS-HashKey)将数据写入到符合范围要求的目标分区。例如,可以将某个日志源端通过 hashkey 与某个主题分区强绑定,这样可以保证数据在该分区上写入和消费是严格保序的。
332
+
333
+
334
+
335
+ #### 输入参数(pb二进制流,位于body中)
336
+
337
+ | 字段名 | 类型 | 位置 | 必须 | 含义 |
338
+ | ------------ | ------- | ---- | ---- | ------------------------------------------------------------ |
339
+ | logGroupList | message | pb | 是 | logGroup 列表,封装好的日志组列表内容,建议 logGroup 数量不要超过5个 |
340
+
341
+ LogGroup 说明:
342
+
343
+ | 字段名 | 是否必选 | 含义 |
344
+ | ----------- | -------- | ------------------------------------------------------------ |
345
+ | logs | 是 | 日志数组,表示有多个 Log 组成的集合,一个 Log 表示一条日志,一个 LogGroup 中 Log 个数不能超过10000 |
346
+ | contextFlow | 否 | LogGroup 的唯一ID,需要使用上下文功能时传入。格式:"{上下文ID}-{LogGroupID}"。<br>上下文ID:唯一标识一个上下文(连续滚动的一系列日志文件,或者是需要保序的一系列日志),16进制64位整型字符串。<br>LogGroupID:连续递增的一串整型,16进制64位整型字符串。样例:"102700A66102516A-59F59"。 |
347
+ | filename | 否 | 日志文件名 |
348
+ | source | 否 | 日志来源,一般使用机器 IP 作为标识 |
349
+ | logTags | 否 | 日志的标签列表 |
350
+
351
+ Log 说明:
352
+
353
+ | 字段名 | 是否必选 | 含义 |
354
+ | -------- | -------- | ------------------------------------------------------------ |
355
+ | time | 是 | 日志时间(Unix 格式时间戳),支持秒、毫秒,建议采用毫秒 |
356
+ | contents | 否 | key-value 格式的日志内容,表示一条日志里的多个 key-value 组合 |
357
+
358
+ Content 说明:
359
+
360
+ | 字段名 | 是否必选 | 含义 |
361
+ | ------ | -------- | ------------------------------------------------------------ |
362
+ | key | 是 | 单条日志里某个字段组的 key 值,不能以`_`开头 |
363
+ | value | 是 | 单条日志某个字段组的 value 值,单条日志 value 不能超过1MB,LogGroup 中所有 value 总和不能超过5MB |
364
+
365
+ LogTag 说明:
366
+
367
+ | 字段名 | 是否必选 | 含义 |
368
+ | ------ | -------- | -------------------------------- |
369
+ | key | 是 | 自定义的标签 key |
370
+ | value | 是 | 自定义的标签 key 对应的 value 值 |
371
+
372
+ ## PB 编译示例
373
+
374
+ 本示例将说明如何使用官方 protoc 编译工具将 PB 描述文件 编译生成为 C++ 语言可调用的上传日志接口。
375
+
376
+ > ?目前 protoc 官方支持 Java、C++、Python 等语言的编译,详情请参见 [protoc](https://github.com/protocolbuffers/protobuf)。
377
+
378
+ #### 1. 安装 Protocol Buffer
379
+
380
+ 下载 [Protocol Buffer](https://main.qcloudimg.com/raw/d7810aaf8b3073fbbc9d4049c21532aa/protobuf-2.6.1.tar.gz) ,解压并安装。示例版本为 protobuf 2.6.1,环境为 Centos 7.3 系统。 解压`protobuf-2.6.1.tar.gz`压缩包至`/usr/local`目录并进入该目录,执行命令如下:
381
+
382
+ ```
383
+ tar -zxvf protobuf-2.6.1.tar.gz -C /usr/local/ && cd /usr/local/protobuf-2.6.1
384
+ ```
385
+
386
+ 开始编译和安装,配置环境变量,执行命令如下:
387
+
388
+ ```
389
+ [root@VM_0_8_centos protobuf-2.6.1]# ./configure
390
+ [root@VM_0_8_centos protobuf-2.6.1]# make && make install
391
+ [root@VM_0_8_centos protobuf-2.6.1]# export PATH=$PATH:/usr/local/protobuf-2.6.1/bin
392
+ ```
393
+
394
+ 编译成功后,您可以使用以下命令查看版本:
395
+
396
+ ```
397
+ [root@VM_0_8_centos protobuf-2.6.1]# protoc --version
398
+ liprotoc 2.6.1
399
+ ```
400
+
401
+ #### 2. 创建 PB 描述文件
402
+
403
+ PB 描述文件是通信双方约定的数据交换格式,上传日志时须将规定的协议格式编译成对应语言版本的调用接口,然后添加到工程代码里,详情请参见 [protoc](https://github.com/protocolbuffers/protobuf) 。
404
+
405
+ 以日志服务所规定的 PB 数据格式内容为准, 在本地创建 PB 消息描述文件 cls.proto。
406
+
407
+ > !PB 描述文件内容不可更改,且文件名须以`.proto`结尾。
408
+
409
+ cls.proto 内容(PB 描述文件)如下:
410
+
411
+ ```
412
+ package cls;
413
+
414
+ message Log
415
+ {
416
+ message Content
417
+ {
418
+ required string key = 1; // 每组字段的 key
419
+ required string value = 2; // 每组字段的 value
420
+ }
421
+ required int64 time = 1; // 时间戳,UNIX时间格式
422
+ repeated Content contents = 2; // 一条日志里的多个kv组合
423
+ }
424
+
425
+ message LogTag
426
+ {
427
+ required string key = 1;
428
+ required string value = 2;
429
+ }
430
+
431
+ message LogGroup
432
+ {
433
+ repeated Log logs = 1; // 多条日志合成的日志数组
434
+ optional string contextFlow = 2; // 目前暂无效用
435
+ optional string filename = 3; // 日志文件名
436
+ optional string source = 4; // 日志来源,一般使用机器IP
437
+ repeated LogTag logTags = 5;
438
+ }
439
+
440
+ message LogGroupList
441
+ {
442
+ repeated LogGroup logGroupList = 1; // 日志组列表
443
+ }
444
+ ```
445
+
446
+ #### 3. 编译生成
447
+
448
+ 此例中,使用 proto 编译器生成 C++ 语言的文件,在 cls.proto 文件的同一目录下,执行如下编译命令:
449
+
450
+ ```
451
+ protoc --cpp_out=./ ./cls.proto
452
+ ```
453
+
454
+ > ?`--cpp_out=./`表示编译成 cpp 格式并输出当前目录下,`./cls.proto`表示位于当前目录下的 cls.proto 描述文件。
455
+
456
+ 编译成功后,会输出对应语言的代码文件。此例会生成 cls.pb.h 头文件和 [cls.pb.cc](http://cls.pb.cc) 代码实现文件,如下所示:
457
+
458
+ ```
459
+ [root@VM_0_8_centos protobuf-2.6.1]# protoc --cpp_out=./ ./cls.proto
460
+ [root@VM_0_8_centos protobuf-2.6.1]# ls
461
+ cls.pb.cc cls.pb.h cls.proto
462
+ ```
463
+
464
+ #### 4. 调用
465
+
466
+ 将生成的 cls.pb.h 头文件引入代码中,调用接口进行数据格式封装。
469
467
  */
470
- DescribeConfigMachineGroups(req: DescribeConfigMachineGroupsRequest, cb?: (error: string, rep: DescribeConfigMachineGroupsResponse) => void): Promise<DescribeConfigMachineGroupsResponse>;
468
+ UploadLog(req: UploadLogRequest, cb?: (error: string, rep: UploadLogResponse) => void): Promise<UploadLogResponse>;
471
469
  /**
472
- * 本接口用于修改特殊采集配置任务,特殊采集配置应用于自建K8S环境的采集Agent
470
+ * 本接口用于创建定时SQL分析任务
473
471
  */
474
- ModifyConfigExtra(req: ModifyConfigExtraRequest, cb?: (error: string, rep: ModifyConfigExtraResponse) => void): Promise<ModifyConfigExtraResponse>;
472
+ CreateScheduledSql(req: CreateScheduledSqlRequest, cb?: (error: string, rep: CreateScheduledSqlResponse) => void): Promise<CreateScheduledSqlResponse>;
475
473
  /**
476
474
  * 本接口用于修改日志集信息
477
475
  */
478
476
  ModifyLogset(req: ModifyLogsetRequest, cb?: (error: string, rep: ModifyLogsetResponse) => void): Promise<ModifyLogsetResponse>;
479
477
  /**
480
- * 本接口用于删除日志下载任务
478
+ * 获取机器组绑定的采集规则配置
481
479
  */
482
- DeleteExport(req: DeleteExportRequest, cb?: (error: string, rep: DeleteExportResponse) => void): Promise<DeleteExportResponse>;
480
+ DescribeMachineGroupConfigs(req: DescribeMachineGroupConfigsRequest, cb?: (error: string, rep: DescribeMachineGroupConfigsResponse) => void): Promise<DescribeMachineGroupConfigsResponse>;
483
481
  /**
484
- * 本接口用于创建告警策略。
482
+ * 本接口用于修改数据加工任务
485
483
  */
486
- CreateAlarm(req: CreateAlarmRequest, cb?: (error: string, rep: CreateAlarmResponse) => void): Promise<CreateAlarmResponse>;
484
+ ModifyDataTransform(req: ModifyDataTransformRequest, cb?: (error: string, rep: ModifyDataTransformResponse) => void): Promise<ModifyDataTransformResponse>;
487
485
  /**
488
- * 本接口用于创建定时SQL分析任务
486
+ * 本接口用于检索分析日志, 该接口除受默认接口请求频率限制外,针对单个日志主题,查询并发数不能超过15。
487
+
488
+ API返回数据包最大49MB,建议启用 gzip 压缩(HTTP Request Header Accept-Encoding:gzip)。
489
489
  */
490
- CreateScheduledSql(req: CreateScheduledSqlRequest, cb?: (error: string, rep: CreateScheduledSqlResponse) => void): Promise<CreateScheduledSqlResponse>;
490
+ SearchLog(req: SearchLogRequest, cb?: (error: string, rep: SearchLogResponse) => void): Promise<SearchLogResponse>;
491
491
  /**
492
- * 本接口仅创建下载任务,任务返回的下载地址,请用户调用DescribeExports查看任务列表。其中有下载地址CosPath参数。参考文档https://cloud.tencent.com/document/product/614/56449
492
+ * 本接口用于搜索日志上下文附近的内容
493
493
  */
494
- CreateExport(req: CreateExportRequest, cb?: (error: string, rep: CreateExportResponse) => void): Promise<CreateExportResponse>;
494
+ DescribeLogContext(req: DescribeLogContextRequest, cb?: (error: string, rep: DescribeLogContextResponse) => void): Promise<DescribeLogContextResponse>;
495
495
  /**
496
- * 本接口用于修改定时SQL分析任务
496
+ * 本接口用于获取投递配置
497
497
  */
498
- ModifyScheduledSql(req: ModifyScheduledSqlRequest, cb?: (error: string, rep: ModifyScheduledSqlResponse) => void): Promise<ModifyScheduledSqlResponse>;
498
+ DescribeConsumer(req: DescribeConsumerRequest, cb?: (error: string, rep: DescribeConsumerResponse) => void): Promise<DescribeConsumerResponse>;
499
499
  /**
500
- * 关闭Kafka协议消费
500
+ * 获取制定机器组下的机器状态
501
501
  */
502
- CloseKafkaConsumer(req: CloseKafkaConsumerRequest, cb?: (error: string, rep: CloseKafkaConsumerResponse) => void): Promise<CloseKafkaConsumerResponse>;
502
+ DescribeMachines(req: DescribeMachinesRequest, cb?: (error: string, rep: DescribeMachinesResponse) => void): Promise<DescribeMachinesResponse>;
503
503
  /**
504
- * 本接口用于获取告警策略列表。
504
+ * 重试失败的投递任务
505
505
  */
506
- DescribeAlarms(req: DescribeAlarmsRequest, cb?: (error: string, rep: DescribeAlarmsResponse) => void): Promise<DescribeAlarmsResponse>;
506
+ RetryShipperTask(req: RetryShipperTaskRequest, cb?: (error: string, rep: RetryShipperTaskResponse) => void): Promise<RetryShipperTaskResponse>;
507
+ /**
508
+ * 本接口用于创建告警策略。
509
+ */
510
+ CreateAlarm(req: CreateAlarmRequest, cb?: (error: string, rep: CreateAlarmResponse) => void): Promise<CreateAlarmResponse>;
511
+ /**
512
+ * 本接口用于删除日志主题。
513
+ */
514
+ DeleteTopic(req: DeleteTopicRequest, cb?: (error: string, rep: DeleteTopicResponse) => void): Promise<DeleteTopicResponse>;
507
515
  }