tencent cloud

Cloud Log Service

NodeJS SDKでログをアップロードする

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-12 15:13:59
AI翻訳
本文では、CLSのNodeJS SDKを使用してログアップロードを迅速に実行する方法を説明します。SDKの使用方法の詳細については、コードリポジトリtencentcloud-cls-sdk-jsを参照してください。

前提条件

TencentCloud APIキー情報であるaccessKeyIdとaccessKeyを作成して取得します。キー情報の取得についてはAPIキー管理にアクセスしてください。
また、キーに関連付けられたアカウントに、対応するSDKログアップロード権限が付与されていることを確認してください。

開発環境の準備

接続を開始する前に、Node.jsをダウンロードしてインストールしてください。ダウンロードアドレスおよび関連操作については、Node.js公式サイトを参照してください。
以下ではCentOS 7システムを例として、次のコマンドを使用して開発環境をインストールできます。
# EPELリポジトリのインストール
sudo yum install epel-release -y
# Node.jsとnpmのインストール
sudo yum install nodejs npm -y

NodeJS SDKのインストール

1. プロジェクトディレクトリを作成して入ります。
2. npmを通じてSDKをインストールします。
npm install
npm install tencentcloud-cls-sdk-js

リクエストパラメータ

変数
タイプ
必須/任意
説明
endpoint
String
はい
ドメイン情報です。入力時は、利用可能なリージョンのAPIアップロードログタブに記載されているドメインをご参照ください。
secretId
String
はい
TencentCloud APIキー情報です。キー情報の取得は、APIキー管理で行ってください。また、キーに関連付けられたアカウントに、対応するSDKログアップロード権限が付与されていることを確認してください。
secretKey
String
はい
TencentCloud APIキー情報です。キー情報の取得は、APIキー管理で行ってください。また、キーに関連付けられたアカウントに、対応するSDKログアップロード権限が付与されていることを確認してください。
sourceIp
String
いいえ
送信元IPアドレス。
retry_times
integer
はい
再試行回数。
topicID
String
はい
日志主题的 ID 信息。

ログアップロードのコード例

以下のコードはNodeJS SDKを例に、SDKを呼び出してログアップロードを実行する操作を示します。
TencentCloud APIキー情報を平文でプロジェクトコードに保存することは推奨しません。環境変数を通じてTencentCloud APIキー情報を動的に取得できます。具体的な操作については、環境変数の設定を参照してください。
const { AsyncClient, LogItem, LogGroup, Content, PutLogsRequest } = require('tencentcloud-cls-sdk-js');

// CLSログサービスのログトピックID、 必須パラメータです。
let topicID = "591XXXXXXXXXXXXXXXXXXXXXXXXXXXX"; // ログトピックIDに置き換えてください。

let client = new AsyncClient({
// ドメイン情報を入力してください。詳細はリンク内のAPIログアップロードタブにあるドメインを参照してください:https://www.tencentcloud.com/document/product/614/18940#.E5.9F.9F.E5.90.8D
endpoint: "ap-xxxxxx.cls.tencentcs.com",
// クラウドAPIキー情報を入力します。キー情報の取得については、https://console.tencentcloud.com/cam/capiにアクセスしてください。
// また、キーに関連付けられたアカウントにログアップロード権限があることを確認してください。権限設定ガイド:https://www.tencentcloud.com/document/product/614/45004#.E4.BD.BF.E7.94.A8-api-.E4.B8.8A.E4.BC.A0.E6.95.B0.E6.8D.AE
// この例では環境変数から取得します。環境変数の設定ガイド:https://www.tencentcloud.com/document/product/614/113851?from_cn_redirect=1
secretId: process.env.TENCENTCLOUD_SECRET_ID,
secretKey: process.env.TENCENTCLOUD_SECRET_KEY,
// ソースIPアドレス: オプションパラメータです。空の場合は自動的にローカルIPを入力します。
sourceIp: "127.XX.XX.1",
// 再試行回数: 必須パラメータです。
retry_times: 10,
});

async function sendLog() {
let item = new LogItem();
item.pushBack(new Content("__CONTENT__", "送信するログ内容")); // 送信したいログ内容に変更します。
item.setTime(Math.floor(Date.now() / 1000));

let loggroup = new LogGroup();
loggroup.addLogs(item);
let request = new PutLogsRequest(topicID, loggroup);

try {
let data = await client.PutLogs(request);
console.log("ログ送信成功:", data);
} catch (error) {
console.error("ログ送信失敗:", error);
}
}

// ログを送信する関数を呼び出します。
sendLog();

おわりに

上記の手順により、Tencent Cloud CLSのNodeJS SDKを使用してログのアップロード操作を迅速に完了できます。問題が発生した場合は、お問い合わせください。


ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック