Jenkins 可観測性のベストプラクティス¶
アカウント登録¶
公式サイト https://guance.com/ にアクセスしてアカウントを登録し、登録済みのアカウント/パスワードでログインします。
DataKit のインストール¶
OpenWay アドレスのトークンを取得する¶
「インテグレーション」モジュール→左上の「DataKit」をクリックし、ご利用のオペレーティングシステムとシステムタイプに応じて適切なインストールコマンドを選択します。
インストールを実行する¶
監視対象のサーバー上で DataKit のインストールコマンドをコピーして直接実行します。
- インストールディレクトリ /usr/local/datakit/
- ログディレクトリ /var/log/datakit/
- メイン設定ファイル /usr/local/datakit/conf.d/datakit.conf
- プラグイン設定ディレクトリ /usr/local/datakit/conf.d/
DataKit のインストールが完了すると、デフォルトで Linux ホストの一般的なプラグインが有効になります。これは、DF → インフラストラクチャ → 組み込みビューで確認できます。
| コレクター名 | 説明 |
|---|---|
| cpu | ホストの CPU 使用率を収集する |
| disk | ディスク使用量を収集する |
| diskio | ホストのディスク IO を収集する |
| mem | ホストのメモリ使用量を収集する |
| swap | スワップメモリ使用量を収集する |
| system | ホストの OS 負荷を収集する |
| net | ホストのネットワークトラフィックを収集する |
| host_process | ホスト上で常駐(10分以上生存)しているプロセスリストを収集する |
| hostobject | ホストの基本情報(OS 情報、ハードウェア情報など)を収集する |
| docker | ホスト上のコンテナオブジェクトとコンテナログを収集する |
[インフラストラクチャ] モジュールをクリックすると、DataKit がインストールされているすべてのホストのリストと、ホスト名、CPU、メモリなどの基本情報を確認できます。
監視シナリオ¶
シナリオの作成¶
「シナリオ」モジュール→「シナリオを作成」をクリックします。
シナリオビューの確認¶
DataKit で Jenkins 収集を有効にする¶
Jenkins の Access keys を取得する¶
「Jenkins にログイン」→「システム管理」→「プラグイン管理」→「利用可能なプラグイン」→ metrics を入力し、「Install without restart」をクリックします。
インストールが完了したら、「システム管理」→「システム設定」→ Metrics を見つけ、右側の「Generate...」をクリックし、「保存」をクリックします。
DataKit の設定¶
jenkins.conf ファイルを作成し、url を Jenkins の URL、key を Metrics のキーに変更します。
DataKit の再起動¶
Jenkins 関連情報¶
Jenkins の概要¶
Jenkins はオープンソースの CI/CD ソフトウェアのリーダーであり、1000 以上のプラグインを提供してビルド、デプロイ、自動化をサポートし、あらゆるプロジェクトのニーズに対応します。
Jenkins パフォーマンスメトリクス¶
| メトリクス | 説明 | データ型 | 単位 |
|---|---|---|---|
| executor_count | 有効なビルド数 | int | count |
| executor_free_count | アイドル状態のビルド数 | int | count |
| executor_in_use_count | 実行中のビルド数 | int | count |
| node_offline_count | オフラインのビルドノード数 | int | count |
| node_online_count | オンラインのビルドノード数 | int | count |
| plugins_active | 起動成功したプラグイン数 | int | count |
| plugins_failed | 起動失敗したプラグイン数 | int | count |
| project_count | プロジェクト数 | int | count |
| job_count | ジョブ数 | int | count |
| queue_blocked | ブロックされているジョブ数 | int | count |
| queue_buildable | ビルド可能なジョブ数 | int | count |
| queue_pending | 保留中のジョブ数 | int | count |
| queue_size | ビルドキュー内のジョブ数 | int | count |
| queue_stuck | スタックしたジョブ数 | int | count |
| system_cpu_load | Jenkins システム負荷 | float | % |
| vm_blocked_count | Jenkins JVM のブロックされたスレッド数 | int | count |
| vm_count | Jenkins JVM の総スレッド数 | int | count |
| vm_cpu_load | Jenkins の CPU 使用率 | float | % |
| vm_memory_total_used | Jenkins が使用するメモリ総量 | int | Byte |





