シークレットプッシュ保護モニタリング

このランブックをいつ使用しますか?

このランブックは、シークレットプッシュ保護機能を監視する際に使用します。GitLab.com で有効になっているときに発生する可能性のある信頼性の問題やパフォーマンスの低下を特定・緩和するために使用します。また、以下の関連ダッシュボードについて理解を深め、改善方法を検討するためにも使用できます:

何を監視しますか?

機能は現在の形では外部コンポーネントを持たず、依存関係としてアプリケーションサーバー内に封じ込まれていますが、プッシュイベントのシーケンス図に示されているように、多くのコンポーネントとやり取りします。それらのコンポーネントは以下の通りです:

GitLab Shell (SSH 経由の Git):
- git-receive-pack
Workhorse (HTTP/S 経由の Git):
- git-receive-pack
Gitaly:
- SSHReceivePack
- PostReceivePack
- PreReceiveHook
- ListAllCommits() RPC（検疫ディレクトリが存在しない場合は ListCommits() RPC）
- FindChangedPaths() RPC
- DiffBlobs() RPC
Rails:
- /internal/allowed エンドポイント

以下は、HTTP または SSH で git push が行われる場合のワークフロー全体を示すシーケンス図です:

sequenceDiagram
    autonumber
    actor User
    User->>+Workhorse/GitLab Shell: git push
    Workhorse/GitLab Shell->>+Gitaly: tcp/ssh
    Gitaly->>+Gitaly: PostReceivePack/SSHReceivePack
    Gitaly->>+Gitaly: git-receive-pack
    Gitaly->>+Gitaly: PreReceiveHook
    Gitaly->>+Rails: grpc
    Note over Gitaly, Rails: invokes /internal/allowed endpoint
    Rails->>+Rails: GitLab::GitAccess
    Rails->>+Rails: EE::GitLab::Checks::ChangesAccess
    Note over Rails: runs Gitlab::Checks::SecretsCheck
    break when special commit message flag is found
        Rails->>+Gitaly: push check skipped
        Gitaly->>+Workhorse/GitLab Shell: outcome of push
        Workhorse/GitLab Shell->>+User: outcome of push
    end
    break when push option is passed
        Rails->>+Gitaly: push check skipped
        Gitaly->>+Workhorse/GitLab Shell: outcome of push
        Workhorse/GitLab Shell->>+User: outcome of push
    end
    Rails->>+Gitaly: ListCommits or ListAllCommits
    Note over Gitaly, Rails: depends on quarantine directory existence
    Gitaly->>+Rails: grpc
    Rails->>+Gitaly: FindChangedPaths
    Note over Gitaly, Rails: returns all changed files for new commits
    Gitaly->>+Rails: grpc
    Rails->>+Rails: Populate PayloadPathsLookupMap with commit sha/file path
    Rails->>+Gitaly: DiffBlobs
    Note over Gitaly, Rails: returns all diff patches for changed files
    Gitaly->>+Rails: grpc
    Rails->>+gitlab-secret_detection: gitlab-secret_detection::Scan
    alt no secret detected
        gitlab-secret_detection->>+gitlab-secret_detection: scan blob
        gitlab-secret_detection->>+Rails: success
        Rails->>+Gitaly: accept - no secret detected
    else scan timeout
        gitlab-secret_detection->>+gitlab-secret_detection: scan blob
        gitlab-secret_detection->>+Rails: fail - timeout
        Rails->>+Gitaly: accept - scan timeout
    else secret detected
        gitlab-secret_detection->>+gitlab-secret_detection: scan blob
        gitlab-secret_detection->>+Rails: fail - secret found
        Rails->>+Rails: Use PayloadPathsLookupMap to retrieve commit sha/file path
        Rails->>+Rails: Format Response
        Rails->>+Gitaly: reject - secret detected
    end
    Gitaly->>+Workhorse/GitLab Shell: outcome of push
    Workhorse/GitLab Shell->>+User: outcome of push

以下は、GitLab 18.7 以降で GetTreeEntries() なしでシークレットプッシュ保護がどのように機能するかを説明するワークフロー図です:

シークレットプッシュ保護ワークフロー

注記: PreReceiveHook を git の pre-receive フックと混同しないでください。前者は実際の git フックのまわりのバイナリラッパーです。フックのセットアップについては Gitaly のドキュメントを参照してください。

これらのコンポーネントが、機能を監視する際に焦点を当てる主要な要素です。

機能の監視方法

上述のとおり、機能は複数のコンポーネントにまたがっています。そのため、機能の監視には異なるツールを使用します:

Kibana（ログ）
- ステージング
  - pubsub-rails-inf-gstg
  - pubsub-gitaly-inf-gstg
  - pubsub-workhorse-inf-gstg
  - pubsub-shell-inf-gstg
- 本番
  - pubsub-rails-inf-gprd
  - pubsub-gitaly-inf-gprd
  - pubsub-workhorse-inf-gprd
  - pubsub-shell-inf-gprd
Kibana（ログビュー）
- gitlab-org/gitlab:
- 全プロジェクト:
Kibana（ビジュアライゼーション）
Prometheus/Grafana（メトリクス）
Sentry（エラートラッキング）

このランブックでは主に Grafana で利用可能な Prometheus メトリクスに焦点を当てていますが、他のツールとその使用方法についても簡潔に説明しています。今後のイテレーションでは、機能の成長と発展に伴い変更される可能性があります。

機能から出力されるログの確認方法

機能から出力されるログを確認するには、以下の Kibana ビューを参照してください:

注記: Kibana は7 日間のみログを保持します。

機能の信頼性またはパフォーマンスの問題を特定・緩和する方法

概要ダッシュボードは、機能を監視するために構築したメインダッシュボードです。信頼性やパフォーマンスの問題を特定しようとする際は、まずここを確認してください。

ダッシュボード自体は 4 つの行（またはセクション）に分かれており、それぞれに以下のようなパネルが含まれています。

GitLab Shell (SSH 経由の Git)

このセクションでは、GitLab Shell 内の機能に関連する特定の操作の安定性を監視します。GitLab Shell は Git SSH セッションを処理するために作成された実行ファイルのセットです。ツール自体は SSH を直接処理しませんが、SSH サーバー/デーモン gitlab-sshd がクライアントとのすべての接続を維持し、認可またはアクセスチェックを実行するために GitLab Shell 経由で Rails を呼び出します。動作の詳細については、この図とリクエストサイクルの説明を参照してください。

このセクションは、SSH で git push 操作を行う際の git-receive-pack 操作に関連するパフォーマンス低下がないことを確認するために使用できます。以下の 2 つの行/セクションに分けられています。

注記: gitlab-shell と gitlab-sshd の両方で利用可能なほとんどのメトリクスは、使用されたコマンドで集計されていません。git-receive-pack 操作のパフォーマンスをより詳細に把握するには、代わりにそれらのセクションにリンクされている Kibana ログを参照してください。

gitlab-shell

RPS (Requests Per Seconds)

このパネルは、時間経過とともに gitlab-shell に対して行われた 1 秒あたりの平均リクエスト数 (RPS) を表示します。リクエストレートを監視し、パフォーマンスまたはスケーラビリティの問題があるかどうかを理解するために使用できます。より詳細な概要はリンクを参照してください。注意: これは git-receive-pack コマンドに固有ではありません。

パネル情報

メトリクス: gitlab_component_ops:rate_5m
ラベルフィルター:
- component = gitlab_shell
- env = gprd
- monitor = global
- stage = main
- type = git
操作:
- 平均値（時間経過）: range | $__interval
凡例:
- RPS

確立された Gitaly 接続の合計

このパネルは、特定の時点で gitlab-shell によって確立された Gitaly 接続の総数を表示します。このパネルは、両コンポーネント間の接続が突然減少したかどうかを確認するために使用でき、パフォーマンスまたは可用性の問題を示す可能性があります。注意: これは git-receive-pack コマンドに固有ではありません。

パネル情報

メトリクス: gitlab_shell_gitaly_connections_total
ラベルフィルター:
- env = gprd
- stage = main
操作:
- カウント:
  - ラベル: status
凡例:
- 自動

確立された SSH セッション

このパネルは、特定の時点での確立された SSH セッションの最小数を表示します。このパネルは、隣接するパネル（特定の時点で確立に失敗した SSH セッションの最大数を表示）と組み合わせて、可用性の問題があるかどうかを理解するために使用できます。注意: これは git-receive-pack コマンドに固有ではありません。

パネル情報

メトリクス: gitlab_sli:shell_sshd_sessions:total
ラベルフィルター:
- env = gprd
- stage = main
- type = git
操作:
- 最小値
凡例:
- 自動

失敗した SSH セッション

このパネルは、特定の時点での失敗した SSH セッションの最大数を表示します。このパネルは、隣接するパネル（特定の時間範囲で確立された SSH セッションの最小数を表示）と組み合わせて、可用性の問題があるかどうかを理解するために使用できます。注意: これは git-receive-pack コマンドに固有ではありません。

パネル情報

メトリクス: gitlab_sli:shell_sshd_sessions:errors_total
ラベルフィルター:
- env = gprd
- stage = main
- type = git
操作:
- 最大値（ラベル別）:
  - ラベル: app
凡例:
- 自動

確立されたセッションの平均時間

このパネルは、24 時間の範囲で合計された確立された SSH セッションの平均時間を表示します。このパネルは、SSH 経由の git pull/push の時間が増加しているかどうかを確認するために使用でき、パフォーマンスまたは可用性の問題を示す可能性があります。注意: これは git-receive-pack コマンドに固有ではありません。

パネル情報

メトリクス:
- gitlab_shell_sshd_session_established_duration_seconds_sum
- gitlab_shell_sshd_session_established_duration_seconds_count
ラベルフィルター:
- env = gprd
- stage = main
- type = git
操作:
- 除算: /
- レート: range | 24h
- 合計
凡例:
- {{label_name}}

全セッションの平均時間

このパネルは、24 時間の範囲で合計された全 SSH セッション（確立済みおよび失敗を含む）の平均時間を表示します。このパネルは、SSH 経由の git pull/push の時間が増加しているかどうかを確認するために使用でき、パフォーマンスまたは可用性の問題を示す可能性があります。注意: これは git-receive-pack コマンドに固有ではありません。

パネル情報

メトリクス:
- gitlab_shell_sshd_session_duration_seconds_sum
- gitlab_shell_sshd_session_duration_seconds_count
ラベルフィルター:
- env = gprd
- stage = main
- type = git
操作:
- 除算: /
- レート: range | 24h
- 合計
凡例:
- {{label_name}}

gitlab-sshd

SLI Apdex

このパネルは、gitlab-sshd SSH デーモン/サーバーのアプリケーションパフォーマンスインデックス（Apdex）を表示します。このサービスレベル指標（SLI）は通常 99.9% 前後で推移しますが、指標の低下は障害または劣化を示す可能性があります。より詳細な概要はリンクを参照してください。注意: これは git-receive-pack コマンドに固有ではありません。

パネル情報

メトリクス: gitlab_component_apdex:ratio_5m
ラベルフィルター:
- component = gitlab_sshd
- env = gprd
- monitor = global
- stage = main
- type = git
操作:
- 最小値（時間経過）: range | $__interval
凡例:
- Apdex

SLI エラー率

このパネルは、gitlab-sshd SSH デーモン/サーバーの最大値にクランプされたエラー比率の最大値を表示します。このサービスレベル指標（SLI）は通常 0.01% 前後で推移しますが、指標の増加は障害または劣化を示す可能性があります。より詳細な概要はリンクを参照してください。注意: これは git-receive-pack コマンドに固有ではありません。

パネル情報

メトリクス: gitlab_component_errors:ratio_5m
ラベルフィルター:
- component = gitlab_sshd
- env = gprd
- monitor = global
- stage = main
- type = git
操作:
- 最大値にクランプ:
  - 最大スカラー: 1
  - 最大値（時間経過）: range | $__interval
凡例:
- Error %

SLI RPS (Requests Per Second)

このパネルは、時間経過とともに gitlab-sshd SSH デーモン/サーバーに対して行われた 1 秒あたりの平均リクエスト数 (RPS) を表示します。リクエストレートを監視し、パフォーマンスまたはスケーラビリティの問題があるかどうかを理解するために使用できます。より詳細な概要はリンクを参照してください。注意: これは git-receive-pack コマンドに固有ではありません。

メトリクス: gitlab_component_ops:ratio_5m
ラベルフィルター:
- component = gitlab_sshd
- env = gprd
- monitor = global
- stage = main
- type = git
操作:
- 平均値（時間経過）: range | $__interval
凡例:
- Error %

Workhorse (HTTP/S 経由の Git)

このセクションでは、Workhorse 内の機能に関連する特定の操作の安定性を監視します。Workhorse は、リソース集約型および長時間実行リクエストを処理するためのスマートリバースプロキシです。すべての HTTP リクエストをインターセプトし、変更せずに転送するか、追加のロジックを実行することで自らが処理します。動作の詳細については、この図とリクエストサイクルの説明を参照してください。

このセクションは、HTTP/S で git push 操作を行う際の git-receive-pack 操作に関連するパフォーマンス低下がないことを確認するために使用できます。

処理された /.git/git-receive-pack リクエスト

このパネルは、時間経過とともに workhorse によって処理された HTTP リクエストの数を 24 時間の範囲で増加して表示します。HTTP verb/メソッドとレスポンスコードでリクエストを区分します。このパネルは、200 以外のレスポンスコードを持つ git-receive-pack リクエストの数が最近増加したかどうかを確認するために使用でき、そのようなリクエストの処理に問題があることを示します。

パネル情報

メトリクス: gitlab_workhorse_git_http_requests
ラベルフィルター:
- exported_service = git-receive-pack
- env = gprd
- stage = main
- code != 0
操作:
- 増加: range | 24h
- 合計:
  - ラベル: code
  - ラベル: method
凡例:
- {{code}} | {{method}}

確立された Gitaly 接続の合計

このパネルは、特定の時点で workhorse によって確立された Gitaly 接続の総数を表示します。このパネルは、両コンポーネント間の接続が突然減少したかどうかを確認するために使用でき、パフォーマンスまたは可用性の問題を示す可能性があります。

パネル情報

メトリクス: gitlab_workhorse_gitaly_connections_total
ラベルフィルター:
- env = gprd
- stage = main
操作:
- カウント:
  - ラベル: status
凡例:
- {{status}}

/.git/git-receive-pack リクエストの平均レイテンシ [全ノード]

このパネルは、workhorse を実行している全ノードの /.git/git-receive-pack リクエストの平均レイテンシ（時間）を秒単位で表示します。この特定のリクエストのレスポンスタイムが増加しているかどうかを確認するために使用でき、特定のしきい値を超えた場合にパフォーマンスの低下を示す可能性があります。

パネル情報

メトリクス:
- gitlab_workhorse_http_request_duration_seconds_sum
- gitlab_workhorse_http_request_duration_seconds_count
ラベルフィルター:
- env = gprd
- stage = main
- route = ^/.+\\.git/git-receive-pack\\z（バックスラッシュのダブルエスケープ）
操作:
- 除算: /
- レート: range | 24h
- 合計:
  - ラベル: node
凡例:
- 自動

SLI Apdex

このパネルは、workhorse コンポーネントのアプリケーションパフォーマンスインデックス（Apdex）を表示します。このサービスレベル指標（SLI）は通常 99.9% 前後で推移しますが、指標の低下は障害または劣化を示す可能性があります。より詳細な概要はリンクを参照してください。注意: これは /.git/git-receive-pack ルートに固有ではありません。

パネル情報

メトリクス: gitlab_component_apdex:ratio_5m
ラベルフィルター:
- component = workhorse
- env = gprd
- monitor = global
- stage = main
- type = git
操作:
- 最小値（時間経過）: range | $__interval
凡例:
- Apdex

SLI エラー率

このパネルは、workhorse の最大値にクランプされたエラー比率の最大値を表示します。このサービスレベル指標（SLI）は通常 0.001% 前後で推移しますが、指標の増加は障害または劣化を示す可能性があります。より詳細な概要はリンクを参照してください。注意: これは /.git/git-receive-pack ルートに固有ではありません。

パネル情報

メトリクス: gitlab_component_errors:ratio_5m
ラベルフィルター:
- component = workhorse
- env = gprd
- monitor = global
- stage = main
- type = git
操作:
- 最大値にクランプ:
  - 最大スカラー: 1
  - 最大値（時間経過）: range | $__interval
凡例:
- Error %

SLI RPS (Requests Per Second)

このパネルは、時間経過とともに workhorse に対して行われた 1 秒あたりの平均リクエスト数 (RPS) を表示します。リクエストレートを監視し、パフォーマンスまたはスケーラビリティの問題があるかどうかを理解するために使用できます。より詳細な概要はリンクを参照してください。注意: これは /.git/git-receive-pack ルートに固有ではありません。

メトリクス: gitlab_component_ops:ratio_5m
ラベルフィルター:
- component = workhorse
- env = gprd
- monitor = global
- stage = main
- type = git
操作:
- 平均値（時間経過）: range | $__interval
凡例:
- Error %

Gitaly

このセクションでは、git リポジトリへの高レベルな RPC アクセスを提供するツールである gitaly の安定性を監視します。このセクションでは、機能が使用するフックと RPC に焦点を当てます。これを使用して、それらに関連するパフォーマンス低下がないことを確認できます。

セクションは以下の 4 つのサブセクションに分かれており、主にレイテンシに焦点を当てています。

GitLab Shell <=> Gitaly:
- SSHReceivePack
Workhorse <=> Gitaly:
- PostReceivePack.
Gitaly <=> Rails API:
- Gitaly / /internal/allowed 前:
  - PreReceiveHook.
- Gitaly / /internal/allowed 中:
  - ListAllCommits() RPC (または ListCommits() RPC)
  - FindChangedPaths() RPC
  - DiffBlobs() RPC

GitLab Shell <=> Gitaly

PostReceivePack – 平均レイテンシ [全ホスト]

このパネルは、PostReceivePack RPC の呼び出しに対する全ホストの平均レイテンシをミリ秒単位で表示します。PostReceivePack RPC は git-receive-pack コマンドを呼び出す責任を持ち、その後 PreReceiveHook を実行します。後者は Rails 側でアクセスチェックを実行する /internal/allowed エンドポイントを呼び出します。

パネル情報

メトリクス: gitaly:grpc_server_handling_seconds:avg5m
ラベルフィルター:
- job = gitaly
- grpc_method = PostReceivePack
操作:
- 平均: 1000 * avg
凡例:
- {{method}}

Workhorse <=> Gitaly

SSHReceivePack – 平均レイテンシ [全ホスト]

このパネルは、SSHReceivePack RPC の呼び出しに対する全ホストの平均レイテンシをミリ秒単位で表示します。SSHReceivePack RPC は（SSH 経由の git push 向けに）git-receive-pack コマンドを呼び出す責任を持ち、その後 PreReceiveHook を実行します。後者は Rails 側でアクセスチェックを実行する /internal/allowed エンドポイントを呼び出します。

パネル情報

メトリクス: gitaly:grpc_server_handling_seconds:avg5m
ラベルフィルター:
- job = gitaly
- grpc_method = SSHReceivePack
操作:
- 平均: 1000 * avg
凡例:
- {{method}}

Gitaly <=> Rails API

Gitaly / `/internal/allowed` 前

PreReceiveHook – 平均レイテンシ [全ホスト]

このパネルは、PreReceiveHook フックの呼び出しに対する全ホストの平均レイテンシをミリ秒単位で表示します。PreReceiveHook は Rails 側でアクセスチェックを実行するために /internal/allowed エンドポイントを呼び出します。

パネル情報

メトリクス: gitaly:grpc_server_handling_seconds:avg5m
ラベルフィルター:
- job = gitaly
- grpc_method = PreReceiveHook
操作:
- 平均: 1000 * avg
凡例:
- {{method}}

Gitaly / `/internal/allowed` 中

ListAllCommits – 平均レイテンシ [全ホスト]

このパネルは、ListAllCommits RPC へのすべての呼び出しの平均レイテンシをミリ秒単位で表示します。ListAllCommits RPC は（機能のコンテキストにおいて）特定のサイズ制限（正確には 1MiB）以下のリポジトリの全新規コミットを列挙する責任を持ちます。

パネル情報

メトリクス: gitaly:grpc_server_handling_seconds:avg5m
ラベルフィルター:
- job = gitaly
- grpc_method = ListAllCommits
操作:
- 平均: 1000 * avg
凡例:
- {{method}}

ListCommits – 平均レイテンシ [全ホスト]

このパネルは、ListCommits RPC へのすべての呼び出しの平均レイテンシをミリ秒単位で表示します。ListCommits RPC は（機能のコンテキストにおいて）特定のサイズ制限（正確には 1MiB）以下のリポジトリの全 Blob を列挙する責任を持ちます。ListAllCommits と同様ですが、それらの Blob のファイルパスも読み込みます。この処理は ListAllCommits よりも遅い場合がよくあります。

パネル情報

メトリクス: gitaly:grpc_server_handling_seconds:avg5m
ラベルフィルター:
- job = gitaly
- grpc_method = ListCommits
操作:
- 平均: 1000 * avg
凡例:
- {{method}}

FindChangedPaths – 平均レイテンシ [全ホスト]

このパネルは、FindChangedPaths RPC へのすべての呼び出しの平均レイテンシをミリ秒単位で表示します。FindChangedPaths RPC は（機能のコンテキストにおいて）プッシュでスキャンされている全新規コミットの変更されたパス/ファイルとそのメタデータ（ファイルパスとコミット SHA）を取得する責任を持ちます。

パネル情報

メトリクス: gitaly:grpc_server_handling_seconds:avg5m
ラベルフィルター:
- job = gitaly
- grpc_method = FindChangedPaths
操作:
- 平均: 1000 * avg
凡例:
- {{method}}

DiffBlobs – 平均レイテンシ [全ホスト]

このパネルは、DiffBlobs RPC へのすべての呼び出しの平均レイテンシをミリ秒単位で表示します。DiffBlobs RPC は（機能のコンテキストにおいて）プッシュでスキャンされた新規コミットの変更されたパス/ファイルの実際のペイロード（差分またはデルタ）を取得する責任を持ちます。

パネル情報

メトリクス: gitaly:grpc_server_handling_seconds:avg5m
ラベルフィルター:
- job = gitaly
- grpc_method = DiffBlobs
操作:
- 平均: 1000 * avg
凡例:
- {{method}}

Rails

このセクションでは、/internal/allowed エンドポイントの安定性を監視します。このエンドポイントは、git プッシュでのシークレット漏洩から保護する機能の要所です。エンドポイントは GitLab の内部 API の一部であり、ユーザーがリポジトリで特定の操作を実行する権限を持っているかどうかを評価する責任を持ちます。

このセクションは、特定の git プッシュの変更がシークレットをスキャンされる際に、/internal/allowed エンドポイントに関連するパフォーマンス低下がないことを確認するために使用できます。

内部 API / リクエストレイテンシ

このパネルは、時間経過とともに /internal/allowed エンドポイントへのリクエストの平均、p95、p99、および平均レイテンシを表示します。この特定のエンドポイントのリクエストレイテンシを監視し、パフォーマンスまたはスケーラビリティの問題があるかどうかを理解するために使用できます。より詳細な概要はリンクを参照してください。

パネル情報

メトリクス:
- controller_action:gitlab_transaction_duration_seconds_sum:rate5m
- controller_action:gitlab_transaction_duration_seconds:p95
- controller_action:gitlab_transaction_duration_seconds:p99
- controller_action:gitlab_transaction_duration_seconds_sum:rate1m
- controller_action:gitlab_transaction_duration_seconds_count:rate1m
ラベルフィルター:
- action = POST /api/internal/allowed
- controller = Grape
- environment = gprd
- stage = main
- type = internal-api
操作:
- 平均値（時間経過）: range | $__interval
- 平均:
  - ラベル: controller
  - ラベル: action
凡例:
- {{action}} – avg
- {{action}} – p95
- {{action}} – p99
- {{action}} – mean

内部 API / RPS (Requests Per Second)

このパネルは、時間経過とともに /internal/allowed エンドポイントへの 1 秒あたりの平均リクエスト数 (RPS) を表示します。この特定のエンドポイントのリクエストレートを監視し、パフォーマンスまたはスケーラビリティの問題があるかどうかを理解するために使用できます。より詳細な概要はリンクを参照してください。

パネル情報

メトリクス:
- controller_action:gitlab_transaction_duration_seconds_count:rate1m
ラベルフィルター:
- action = POST /api/internal/allowed
- controller = Grape
- environment = gprd
- stage = main
- type = internal-api
操作:
- 平均値（時間経過）: range | $__interval
- 合計:
  - ラベル: controller
  - ラベル: action
凡例:
- {{action}}

内部 API / メモリ飽和率

このパネルは、内部 API の 2 つのコンポーネント（Ruby VM と Puma Workers）のメモリ飽和率を表示します。Rails のメモリ消費が飽和点まで増加しているかどうかを理解するのに役立ち、パフォーマンスとスケーラビリティの問題を示し、対応が必要です。注意: このパネルは /internal/allowed エンドポイントに固有ではありません。

パネル情報

メトリクス:
- gitlab_component_saturation:ratio
ラベルフィルター:
- env = gprd
- environment = gprd
- stage = main
- type = internal-api
- component = ruby_thread_contention | puma_workers
操作:
- 最大値（時間経過）: range | $__interval
- 最大:
  - ラベル: component
凡例:
- 自動

その他のサポートはどこで求めればよいですか?

不明な点がある場合は、#g_secure-secret-detection チャンネルでいつでもサポートを求めることができます。

このランブックを改善するには?

このランブックは、機能の進化と進歩に合わせて更新する必要があります。以下のガイドラインに従って最新の状態に保ってください。

ダッシュボードのパネルが更新された場合

ダッシュボードのパネルが更新された場合は、必要に応じてパネル情報と説明を更新してください。

新しいパネルが追加された場合

新しいパネルがダッシュボードに作成された場合は、以下に示すのと同じ形式を使用して名前、説明、および情報を追加してください。

**太字のパネル名**

パネルが何をするか、パフォーマンスの低下や信頼性の問題を特定するためにどのように使用できるかを説明する数文。

_パネル情報_

* Metric: `NAME_OF_METRIC_USED`
* Label Filters:
  * `LIST_OF_LABELS_USED_TO_FILTER_BY_IN_KEY_AND_VALUE`
* Operations:
  * `LIST_OF_OPERATIONS_APPLIED_ON_DATA`
* Legend:
  * `LEGEND_USED_IF_NOT_AUTOMATIC`

パネルが削除された場合

ダッシュボードからパネルが削除された場合は、このランブックから対応するセクションを削除することを検討してください。

シークレットプッシュ保護モニタリング

このランブックをいつ使用しますか?

何を監視しますか?

機能の監視方法

機能から出力されるログの確認方法

機能の信頼性またはパフォーマンスの問題を特定・緩和する方法

GitLab Shell (SSH 経由の Git)

gitlab-shell

gitlab-sshd

Workhorse (HTTP/S 経由の Git)

Gitaly

GitLab Shell <=> Gitaly

Workhorse <=> Gitaly

Gitaly <=> Rails API

Gitaly / `/internal/allowed` 前

Gitaly / `/internal/allowed` 中

Rails

その他のサポートはどこで求めればよいですか?

このランブックを改善するには?

ダッシュボードのパネルが更新された場合

新しいパネルが追加された場合

パネルが削除された場合

関連ダッシュボードへの貢献方法

新しいコンポーネントが機能で使用される場合

コンポーネントが不要になった場合

シークレットプッシュ保護 モニタリング

このランブックをいつ使用しますか?

何を監視しますか?

機能の監視方法

機能から出力されるログの確認方法

機能の信頼性またはパフォーマンスの問題を特定・緩和する方法

GitLab Shell (SSH 経由の Git)

gitlab-shell

gitlab-sshd

Workhorse (HTTP/S 経由の Git)

Gitaly

GitLab Shell <=> Gitaly

Workhorse <=> Gitaly

Gitaly <=> Rails API

Gitaly / /internal/allowed 前

Gitaly / /internal/allowed 中

Rails

その他のサポートはどこで求めればよいですか?

このランブックを改善するには?

ダッシュボードのパネルが更新された場合

新しいパネルが追加された場合

パネルが削除された場合

関連ダッシュボードへの貢献方法

新しいコンポーネントが機能で使用される場合

コンポーネントが不要になった場合

シークレットプッシュ保護モニタリング

Gitaly / `/internal/allowed` 前

Gitaly / `/internal/allowed` 中