• 要件
• 設定
• インストールのコマンドラインオプション
• Chart設定例
  • extraEnv
  • 追加EnvFrom
  • 画像.pullSecrets
  • 注釈
• グローバル設定
• チャート設定
  • メトリクス.enabled

GitLab-Exporterチャートの使い方

gitlab-exporter サブチャートは GitLab アプリケーション固有のデータに対する Prometheus メトリクスを提供します。PostgreSQLに直接アクセスしてクエリを実行し、CIビルドやプルミラーなどのデータを取得します。さらに、Sidekiq API を使って Redis とやり取りし、Sidekiq キューの状態 (ジョブ数など) に関するさまざまなメトリクスを収集します。

要件

このチャートはRedisとPostgreSQLのサービスに依存しています。RedisとPostgreSQLは完全なGitLabチャートの一部であるか、このチャートがデプロイされているKubernetesクラスターから到達可能な外部サービスとして提供されています。

設定

gitlab-exporter Chart の設定は以下の通りです：グローバル設定と チャート設定。

インストールのコマンドラインオプション

以下の表は、--set フラグを使用して、helm install コマンドに供給できるすべての可能なチャート設定を示しています。

Chart設定例

extraEnv

extraEnv を使用すると、ポッド内のすべてのコンテナで追加の環境変数を公開できます。

以下は、extraEnv の使用例です：

extraEnv:
  SOME_KEY: some_value
  SOME_OTHER_KEY: some_other_value

コンテナを起動すると、環境変数が公開されていることが確認できます：

env | grep SOME
SOME_KEY=some_value
SOME_OTHER_KEY=some_other_value

追加EnvFrom

extraEnvFrom を使用すると、ポッド内のすべてのコンテナで、他のデータソースからの追加の環境変数を公開することができます。

以下は、extraEnvFrom の使用例です：

extraEnvFrom:
  MY_NODE_NAME:
    fieldRef:
      fieldPath: spec.nodeName
  MY_CPU_REQUEST:
    resourceFieldRef:
      containerName: test-container
      resource: requests.cpu
  SECRET_THING:
    secretKeyRef:
      name: special-secret
      key: special_token
      # optional: boolean
  CONFIG_STRING:
    configMapKeyRef:
      name: useful-config
      key: some-string
      # optional: boolean

画像.pullSecrets

pullSecrets を使用すると、非公開レジストリで認証してポッドのイメージをプルできるようになります。

非公開レジストリとその認証方法の詳細については、Kubernetesのドキュメントを参照してください。

以下は、pullSecrets の使用例です：

image:
  repository: my.image.repository
  pullPolicy: Always
  pullSecrets:
  - name: my-secret-name
  - name: my-secondary-secret-name

注釈

annotations を使うと、GitLab Exporterのポッドにアノテーションを追加することができます。例えば

annotations:
  kubernetes.io/example-annotation: annotation-value

グローバル設定

私たちのChartには共通のグローバル設定があります。GitLabやレジストリのホスト名など、共通の設定オプションについてはGlobals Documentationをご覧ください。

チャート設定

以下の値はGitLab Exporterポッドの設定に使用されます。

メトリクス.enabled

デフォルトでは、ポッドは/metrics でメトリクス・エンドポイントを公開します。メトリクスを有効にすると、各ポッドにアノテーションが追加され、Prometheusサーバーが公開されたメトリクスを検出してスクレイピングできるようになります。