tencent cloud

浏览器 JavaScript SDK上传日志
下载PDF
最后更新时间：2025-11-07 17:40:38
浏览器 JavaScript SDK上传日志
最后更新时间： 2025-11-07 17:40:38
下载PDF
本文介绍如何快速使用日志服务的浏览器 JavaScript SDK 实现日志上传的操作。更多 SDK 使用的详细内容，可见代码仓库 tencentcloud-cls-sdk-js-web。

前提条件

请确保日志主题开启 匿名日志采集。

准备开发环境

开始接入前，请先下载并安装 Node.js。下载地址及相关操作请查看 Node.js 官网。
以下以 CentOS 系统为例，可使用如下命令安装开发环境。
# 安装EPEL仓库
sudo yum install epel-release -y
# 安装Node.js和npm
sudo yum install nodejs npm -y

安装浏览器 JavaScript SDK

1. 创建并进入项目目录。
git clone  https://github.com/TencentCloud/tencentcloud-cls-sdk-js.git
cd tencentcloud-cls-sdk-js
2. 通过 npm 安装 SDK。
npm install
npm install tencentcloud-cls-sdk-js-web

请求参数

变量
类型
是否必填
说明
endpoint
String
是
域名信息，填写请参见 可用地域 中 API上传日志 Tab 中的域名。
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://www.tencentcloud.com/document/product/614/18940?from_cn_redirect=1#.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 添加到 LogGroup
logGroup.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();

结语

通过以上步骤，您可以快速使用腾讯云 CLS 的 浏览器 JavaScript SDK 完成日志的上传操作。如遇到任何问题，请 联系我们 获取帮助。
本页内容是否解决了您的问题？
您也可以 联系销售 或 提交工单 以寻求帮助。
是
否

文档反馈