SaaS / セルフマネージド / Dedicated トラブルシューティング表
GitLab の各プラットフォームタイプにおける、さまざまな問題のトラブルシューティングのヒント
概要
このページの目的は、サポートエンジニアが任意の GitLab プラットフォーム上のさまざまな問題に対するトラブルシューティングのヒントを必要としたときに使用できる、単一の参照ポイントを提供することです。これにより、各サポートエンジニアが、関係する GitLab プラットフォームに関係なく、サポートチケットをより容易に解決できるようにすることを目指します。
このページの使い方
ご自身の関心のあるトピックを見つけ、対象となる GitLab プラットフォーム（セルフマネージド、SaaS、または Dedicated）に該当するテーブル行内の指示に従ってください。
ログとパフォーマンス
| セルフマネージド | GitlabSOS は、潜在的な問題をさらに調査するためにお客様のインスタンスからすべてのログを収集する優れた手段です。 GitLabSOS と同様に、お客様がソースまたは omnibus インストールではなく Kubernetes を利用している場合は KubeSOS を使用してください。 Fast-stats は GitLab ログから、また GitLab ログ間でパフォーマンス分析を比較する優れた手段です。 Green-hat は実験的な SOS およびログパーサーです。GitLab Log Analysis: この実験的プロジェクトは、Kibana、Filebeat、Elasticsearch、Logstash を使って GitLab ログを分析するための環境を構築します。起動時にダッシュボードが自動でインポートされ、ログ分析の準備が整います。 |
| DotCom | Kibana は Elasticsearch クラスターでインデックス化されたコンテンツの上に可視化機能を提供し、Web ベースのクエリで情報を見つけることができます。このツールでどのような情報が引き出せるかを理解するには、ヒントとテクニックを確認してください。 Sentry は、たとえば Ruby コード関連のエラーなど、さまざまなアプリケーションまたは環境にまたがるエラーの調査に役立ちます。Sentry での検索は通常、Correlation ID を使用して行います。 Grafana は GitLab.com のインフラメトリクス収集に使用されています。 |
| Dedicated | GitLab Dedicated Logs ワークフローには、Opensearch を使ってログを表示する方法に関する情報があります。Observability and Monitoring ワークフローには、Grafana を使ってパフォーマンスの問題を診断する方法に関する情報があります。 |
構成
| セルフマネージド | お客様はセルフマネージドインスタンスの構成を自身で管理します。デプロイ方法に応じて、構成は /etc/gitlab/gitlab.rb、docker-compose.yml、values.yaml または同様のファイルにあります。 |
| DotCom | GitLab.com の構成はインフラチームによって管理されており、個々のお客様のニーズに合わせて変更することはできません。 |
| Dedicated | GitLab Dedicated のお客様は、Switchboard および Admin Area を経由してテナントを構成できます。GitLab サポートチームのメンバーは、こちらの手順に従って Okta 経由で Switchboard にアクセスできます。一部の構成変更は、Request for Help Issue を経由して行う必要があります。 |
アーキテクチャ
| セルフマネージド | お客様に推奨しているリファレンスアーキテクチャとそのさまざまなバリエーションをご確認ください。 |
| DotCom | GitLab.com のアーキテクチャはインフラチームによって管理されており、個々のお客様のニーズに合わせて変更することはできません。 |
| Dedicated | GitLab Dedicated は、GitLab Dedicated Group によって AWS 上で管理されている、完全に分離されたシングルテナントの SaaS サービスです。GitLab Dedicated テナントは、高可用性を有効にした GitLab のCloud Native Hybrid リファレンスアーキテクチャを使用しています。リファレンスアーキテクチャからの変更点の一覧をご確認ください。 |
認証
| セルフマネージド | セルフマネージドの管理者は、希望する認証プロバイダーを構成する必要があり、構成は gitlab.rb で直接行います。このファイルに対する設定変更は、変更を反映するために gitlab-ctl reconfigure の実行が必要です。 |
| DotCom | お客様は Group > Settings > SAML SSO に移動して、グループ向けの SAML SSO を直接構成できます。 |
| Dedicated | SAML がサポートされています。調査はログを検索するところから始めてください。エスカレーションするには、GitLab Dedicated チームに Issue を起票してください。 |
Geo
| セルフマネージド | Geo は gitlab.rb 内で構成します。Premium 以上のサブスクリプションが必要です。手順は記載されている順序で実行する必要があります。 |
| DotCom | Geo は gitlab.com 上ではお客様による構成は提供されていません。 |
| Dedicated | GitLab Geo はいくつかの制約ありでサポートされています。Dedicated チームに Issue を起票してください。 |
Admin Area
| セルフマネージド | セルフマネージドシステムの管理者は、自分のインスタンスの管理画面にアクセスできます。 |
| DotCom | GitLab.com 上では、GitLab チームメンバーのみが管理タスクを行うことができ、お客様にはアクセス権が付与されません。 |
| Dedicated | お客様には Admin Area にアクセスできるインスタンス管理者がいます。お客様向けの GitLab Rails コンソールアクセスはありません。 |
参照には Admin Area のドキュメントを使用してください。
Gitaly
| セルフマネージド | Gitaly の構成は gitlab.rb ファイルを通じて管理されます。お客様は git の要件を満たすために、スタンドアロンの Gitaly を構成することも、Gitaly Cluster を活用することもできます。トラブルシューティングを始める前に、セルフマネージドのお客様がどちらのタイプの Gitaly 構成を使用しているか必ず確認してください。 |
| DotCom | Gitaly は GitLab のインフラチームによって管理されているため、お客様はアクセスできません。 |
| Dedicated | Gitaly は Environment Automation SRE によって管理されています。必要に応じて RFH を起票してください。 |
サブスクリプション
| Dedicated | GitLab Dedicated のお客様は Ultimate を利用できますが、一部の機能は GitLab Dedicated では利用できない点にご注意ください。 |
| DotCom | GitLab.com を利用される方向けの利用可能なプランには、Free、Premium、Ultimate が含まれます。 |
| セルフマネージド | セルフマネージドインスタンスの場合は、ライセンスなしで GitLab CE（Community Edition）または GitLab EE（Enterprise Edition）のいずれかを利用できます。GitLab EE は Premium または Ultimate ライセンスでアクティベートできます。 |
GitLab Duo アドオンはサブスクリプションとは別に取り扱われる点にご注意ください。
Runner
| セルフマネージド | セルフマネージド Runner はお客様が所有するインフラにデプロイされ、セルフマネージドの GitLab インスタンスに登録されます。 |
| DotCom | GitLab ホステッド Runner は GitLab.com に保存されているすべてのプロジェクトで利用できます。セルフマネージド Runner も GitLab.com に登録できます。 |
| Dedicated | GitLab ホステッド Runner（ベータ）は Dedicated のお客様向けにプロビジョニングできます。セルフマネージド Runner も Dedicated 環境に登録できます。 |
Rails コンソール
| セルフマネージド | Rails コンソールのコマンドは、Rails ノード上でRails コンソールを起動することで実行できます。 |
| DotCom | GitLab.com では、Rails コンソールへは内部リクエストを作成することでアクセスできます。 |
| Dedicated | Dedicated では Rails コンソールは利用できません。緊急の事案については、Dedicated チームへの Request for Help を作成してください。 |
フィーチャーフラグ
| セルフマネージド | インスタンス管理者は Rails コンソール経由でフィーチャーフラグを有効化できます。 |
| DotCom | GitLab.com 上では、一部のフィーチャーフラグは chatops を経由して有効化できます。 |
| Dedicated | GitLab Dedicated では、フィーチャーフラグがデフォルトで有効化されるまで利用できません。GitLab Dedicated のお客様からのフィーチャーフラグリクエストの取り扱いについての詳細をご確認ください。 |
最終更新 June 14, 2026: Merge pull request #403 from kyama0/claude/cool-turing-ls6eck (
bfd74782)