tencent cloud

Cloud Log Service

Windows環境ログのCLSへの収集

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-12 15:13:58
AI翻訳

操作シナリオ

このドキュメントでは、WinlogbeatまたはFilebeatを使用してWindows環境のログを収集し、CLSにアップロードする方法について説明します。

前提条件

CLS(Cloud Log Service)を有効化し、対応するリソース(ログセットやログトピックなど)を作成しました。
Tencent Cloud CAMコンソールでSecretIdとSecretKeyを取得しました。

操作手順

LogListener Windows版を使用したWindowsイベントログの収集

詳細については、Windowsイベントログの収集をご参照ください。

Filebeatを使用したWindowsファイルログの収集

説明:
このドキュメントの例は、Filebeat 9.0以降のバージョンに適用されます。Filebeatのlog inputは廃止されたため、filestream inputを使用してファイルログを収集してください。
1. インストールパッケージをダウンロードした後、対象のWindowsホストのいずれかのドライブのルートディレクトリにアップロードし、解凍してください。
2. 管理者としてPowerShellを開き、解凍後のファイルディレクトリにcdし、以下のコマンドを実行してFilebeatサービスをインストールします。
インストールスクリプトを実行し、Filebeatサービスをインストールします。
.\\install-service-filebeat.ps1

Filebeatを構成しCLSへログをアップロードする

Filebeatのインストールディレクトリで、filebeat.reference.ymlファイルを見つけ、コピーしてfilebeat.ymlという名前を付けます。filebeat.inputsとoutput.kafkaを設定し、Filebeatがローカルファイルのログを収集してCLS Kafkaプロデューサーに送信するようにします。例に示すログパス、リージョン、CLSリソース識別子を実際の値に置き換えてください。
filebeat.inputs:
- type: filestream
id: cls-windows-file
enabled: true
paths:
- "C:/Logs/*.log" # TODO 実際のログパスに置き換えてください

output.kafka:
enabled: true
hosts: ["${kafka-region}-producer.cls.tencentyun.com:9095"] # サービスアドレス、${kafka-region}は地域の略称です
topic: "${topicID}" # TODO topicID
version: "1.0.0" # Filebeatのバージョンと一致させる必要があります:Filebeat 9.0以降は1.0.0を入力し、8.18以前は0.11.0.2を入力します。
compression: "${compress}" # 圧縮方式を設定します。gzip、snappy、lz4をサポートしています。例えば「lz4」です。
username: "${logsetID}"
password: "${secret_id}#${secret_key}"
注意:
各filestream inputには、ファイル読み取り状態を追跡するために、一意かつ安定したidを設定する必要があります。すでに本番環境で使用しているidを任意に変更しないでください。変更すると、重複して収集される可能性があります。
hosts内の${kafka-region}は地域の略称(広州はgz、上海はshなど)であり、ap-guangzhouではありません。詳しいhostsの入力方法については、サービス入口をご覧ください。

設定を検証しFilebeatを起動する

設定が完了したら、PowerShellで以下のコマンドを実行します。
# 設定ファイルの構文を検証します。
.\\filebeat.exe test config -c .\\filebeat.yml -e

# CLS Kafkaプロデューサーとの接続性を検証します。
.\\filebeat.exe test output -c .\\filebeat.yml -e

# Filebeatをフォアグラウンドで起動し、収集および報告結果を検証します。
.\\filebeat.exe -c .\\filebeat.yml -e
説明:
filebeat setupは、Elasticsearchインデックステンプレート、ILMポリシー、Kibana DashboardなどのElastic Stackアセットを初期化するために使用され、Filebeatを起動しません。CLSがKafka出力を使用する場合、filebeat setupを実行する必要はなく、filebeat -cを使用して直接起動してください。フォアグラウンドでの検証が完了したら、フォアグラウンドプロセスを停止し、Start-Service filebeatを実行してFilebeatサービスを起動できます。
パラメータ
説明
認証メカニズム
現在、SASL_PLAINTEXTをサポートしています。
hosts
CLS Kafka アドレスです。書き込み先ログトピックのリージョンに基づいて設定します。サービスエントリを参照してください。
topic
CLS Kafka トピック名です。ログトピック ID として設定します。例:76c63473-c496-466b-XXXX-XXXXXXXXXXXX。
username
CLS Kafka アクセスユーザー名です。ログセット ID として設定します。例:0f8e4b82-8adb-47b1-XXXX-XXXXXXXXXXXX。
password
CLS Kafka アクセスパスワードです。形式は ${secret_id}#${secret_key} です。例:XXXXXXXXXXXXXX#YYYYYYYY。キー情報の取得は キー取得 に進んでください。

サービス入口

リージョン
ネットワークタイプ
ポート番号
サービスエントリ
広州
イントラネット
9095
gz-producer.cls.tencentyun.com:9095
外部ネットワーク
9096
gz-producer.cls.tencentcs.com:9096
注意:
本ドキュメントでは広州地域を例にしています。内部・外部ネットワークのドメイン名は異なるポートで識別する必要があります。その他の地域ではアドレスプレフィックスを置き換えてください。詳細については、利用可能なドメイン名 – Kafka ログアップロードをご参照ください。


ヘルプとサポート

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

フィードバック