前提条件
准备开发环境
开始接入前,请先下载并安装 Node.js。下载地址及相关操作请查看 Node.js 官网。
以下以 CentOS 系统为例,可使用如下命令安装开发环境。
# 安装EPEL仓库sudo yum install epel-release -y# 安装Node.js和npmsudo yum install nodejs npm -y
安装 浏览器 JavaScript SDK
1. 创建并进入项目目录。
git clone https://github.com/TencentCloud/tencentcloud-cls-sdk-js.gitcd tencentcloud-cls-sdk-js
2. 通过npm 安装 SDK。
npm installnpm install tencentcloud-cls-sdk-js-web
请求参数
变量 | 类型 | 是否必填 | 说明 |
endpoint | String | 是 | |
retry_times | integer | 是 | 重试次数。 |
Source | String | 否 | 来源 IP 地址。 |
topicID | String | 是 | 日志主题的 ID 信息。 |
日志上传代码示例
以下代码以浏览器 JavaScript 为例,展示通过调用 SDK 完成日志上传的操作。
const { Log, LogGroup, AsyncClient, PutLogsRequest } = require('tencentcloud-cls-sdk-js-web');// 创建 AsyncClient 实例let client = new AsyncClient({endpoint: "ap-xxxxxxx.cls.tencentcs.com", // 填入域名信息,填写指引:https://cloud.tencent.com/document/product/614/18940#.E5.9F.9F.E5.90.8D,请参见链接中 API 上传日志 Tab 中的域名retry_times: 10,});// 创建 LogGroup 实例let logGroup = new LogGroup();logGroup.setSource("1.X.XX.XX"); // 替换为您的 IP 地址// 创建 Log 实例let log = new Log(Date.now());log.addContent("hello", "hello world1");log.addContent("world", "hello world2");// 将 Log 添加到 LogGrouplogGroup.addLog(log);// 创建 PutLogsRequest 实例let request = new PutLogsRequest("8bbXXXXXXXXXXXXXXXXXXXXXXXXXXXX", logGroup); // 替换为您的 topicID// 上传日志async function uploadLogs() {try {let data = await client.PutLogs(request);console.log("Logs uploaded successfully:", data);} catch (error) {console.error("Error uploading logs:", error);}}// 调用上传日志的函数uploadLogs();
结语