tencent cloud

Cloud Log Service

Java SDKによるログアップロード

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

前提条件

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

開発環境の準備

Java公式サイトを参照して、Java開発環境をダウンロードしてインストールしてください。
CLS Java SDKはJRE 6.0以降のJava実行環境をサポートしています。以下のコマンドを実行して、現在のJavaバージョンを確認できます。
java -version

Java SDKのインストール

Mavenプロジェクトに依存関係を追加する方法でJava SDKを導入することをお勧めします。
MavenプロジェクトでCLS Java SDKを使用するには、pom.xmlに対応する依存関係を追加するだけで済みます。Mavenプロジェクト管理ツールが関連するJARパッケージを自動的にダウンロードします。
<dependency>
<groupId>com.tencentcloudapi.cls</groupId>
<artifactId>tencentcloud-cls-sdk-java</artifactId>
<version>1.0.15</version>
</dependency>

リクエストパラメータ

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

ログアップロードのサンプルコード

Java SDKの使用を例に、SDKを呼び出してログアップロードを実行する操作を示します。サンプルコードは以下の通りです。
TencentCloud APIキー情報を平文でプロジェクトコードに保存することは推奨しません。環境変数を通じてTencentCloud APIキー情報を動的に取得できます。具体的な操作については、環境変数の設定を参照してください。
import com.tencentcloudapi.cls.sdk.AsyncProducerClient;
import com.tencentcloudapi.cls.sdk.AsyncProducerConfig;
import com.tencentcloudapi.cls.sdk.LogItem;
import com.tencentcloudapi.cls.sdk.LogContent;
import com.tencentcloudapi.cls.sdk.NetworkUtils;

import java.util.ArrayList;
import java.util.List;

public class TencentClsDemo {
public static void main(String[] args) {
// ドメイン名情報を入力してください。ドメイン名については、リンク内のAPIアップロードログタブにあるドメイン名を参照してください:https://www.tencentcloud.com/document/product/614/18940#.E5.9F.9F.E5.90.8D
String endpoint = "ap-xxxxxx.cls.tencentcs.com";
// TencentCloud 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
String secretId = System.getenv("TENCENTCLOUD_SECRET_ID");
String secretKey = System.getenv("TENCENTCLOUD_SECRET_KEY");
// ログトピックIDを入力してください。
String topicId = "5912XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";

final AsyncProducerConfig config = new AsyncProducerConfig(endpoint, secretId, secretKey, NetworkUtils.getLocalMachineIP());

// クライアントインスタンスを構築します。
final AsyncProducerClient client = new AsyncProducerClient(config);

for (int i = 0; i < 10000; ++i) {
List<LogItem> logItems = new ArrayList<>();
int ts = (int) (System.currentTimeMillis() / 1000);
LogItem logItem = new LogItem(ts);
logItem.PushBack(new LogContent("__CONTENT__", "hello world"));
logItem.PushBack(new LogContent("city", "guangXXXXX"));
logItem.PushBack(new LogContent("logNo", Integer.toString(i)));
logItem.PushBack(new LogContent("__PKG_LOGID__", (String.valueOf(System.currentTimeMillis()))));
logItems.add(logItem);
client.putLogs(topicId, logItems, result -> System.out.println(result.toString()));
}
client.close();
}
}

おわりに

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

ヘルプとサポート

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

フィードバック