Docker インストール¶
DataWay データゲートウェイアドレスの選択¶
DataWay は Guance のデータゲートウェイであり、データ収集ツールが Guance にデータをレポートする際には、必ず DataWay ゲートウェイを経由する必要があります。
コンテナ方式での DataKit インストール¶
sudo docker run \
--hostname "$(hostname)" \
--workdir /usr/local/datakit \
--name datakit-docker \
-v "/host/conf/dir":"/usr/local/datakit/conf.d/host-inputs-conf" \
-v "/":"/rootfs" \
-v /var/run/docker.sock:/var/run/docker.sock \
-e ENV_DATAWAY="https://openway.guance.com?token=tkn_7f5********fda8681" \
-e ENV_GLOBAL_HOST_TAGS="" \
-e ENV_HTTP_LISTEN="0.0.0.0:9529" \
-e HOST_PROC="/rootfs/proc" \
-e HOST_SYS="/rootfs/sys" \
-e HOST_ETC="/rootfs/etc" \
-e HOST_VAR="/rootfs/var" \
-e HOST_RUN="/rootfs/run" \
-e HOST_DEV="/rootfs/dev" \
-e HOST_ROOT="/rootfs" \
--cpus 2 \
--memory 1g \
--privileged \
--publish 9529:9529 \
-d \
pubrepo.guance.com/datakit/datakit:1.86.2
インストール時には、インストールコマンドに環境変数を追加することで、DataKit の一部設定を定義できます。
詳細は環境変数の一覧をご参照ください。
よく使う設定¶
- ホストマシンのディレクトリを選択します。例:
/host/conf/dir。 - ホストマシンのポートを選択します。例:9529。
- DataKit の名前を定義します。例:datakit-docker。
- インストールする DataKit のバージョンを選択します(デプロイメントプランの場合は指定が必要)。
- グローバルホストタグを追加します。複数のタグはカンマで区切ります。例:
host=datakit_hostname。 - 有効にするデータ収集ツールを指定します。デフォルトでは一部のホスト関連データ収集ツールが有効になります。例:
cpu、mem、disk。
RUM リアルユーザーモニタリング & HTTP¶
-
DataKit HTTP サービスのアドレスを設定します(❗️RUM 機能を使用する場合は、パブリックアクセス可能なアドレスを設定する必要があります)。例:
localhost。 -
RUM データ収集ツールを有効にするかどうかを選択します。
-
IP 地理位置情報データベースをインストールするかどうかを選択します。
-
DataKit の 404 ページを無効にするかどうかを選択します。
APM アプリケーションパフォーマンスモニタリング¶
DDTrace データ収集ツールを有効にするかどうかを選択します。
DCA¶
DCA サービスを有効にするかどうかを選択します。
DataKit の使用¶
インストール後、以下のコマンドを実行して DataKit の動作状況を確認できます。
コンテナ実行パラメータの説明¶
| パラメータ | 説明 |
|---|---|
--hostname |
ホストマシンのホスト名を DataKit のホスト名として使用します。同じホストマシン上で複数の DataKit を実行する必要がある場合は、適宜サフィックスを追加できます。例:--hostname "$(hostname)-dk1" |
--workdir |
コンテナの作業ディレクトリを設定します |
-v |
ホストマシンのファイルをマウントします。コンテナがホストマシンのシステムリソースにアクセスするために使用します |
-e |
DataKit 実行時の環境変数を設定します |
--publish |
外部からのトレースなどのデータを受信するために、DataKit コンテナの HTTP ポート(デフォルト 9529)をホストマシンにマッピングします。データ送信先アドレスを設定する際は、ホストマシンの IP と 9529 ポートを指定してください |