メインコンテンツへスキップ
非推奨 — v1.x チャートこのページでは、メンテナンスモードの v1.x インラインテンプレート Helm チャートの設定について説明します。v2.x チャートについては、Helm 設定 を参照してください。移行については、アップグレードガイド を参照してください。
このガイドでは、ClickStack の Helm デプロイメントで使用できる設定オプションを説明します。基本的なインストールについては、メインの Helm デプロイメントガイド を参照してください。

API キーの設定

ClickStack のデプロイが完了したら、テレメトリーデータの収集を有効にするため、API キーを設定します。
  1. 設定済みのイングレスまたはサービスのエンドポイント から HyperDX インスタンスにアクセス します
  2. HyperDX ダッシュボードにログイン し、Team Settings に移動して API キーを生成または取得します
  3. 以下のいずれかの方法で、API キーを使用してデプロイメントを更新 します:

方法1: valuesファイルを使って Helm upgrade で更新

values.yaml に API キー を追加します:
次に、デプロイを更新します:

方法 2: —set フラグを指定して Helm upgrade で更新

変更を反映するためにポッドを再起動する

APIキーを更新したら、新しい設定を反映させるためにポッドを再起動します:
この チャート は、API キー を含む Kubernetes Secret (<release-name>-app-secrets) を自動的に作成します。外部 Secret を使用する場合を除き、追加の Secret 設定は不要です。

シークレット管理

APIキーやデータベース認証情報などの機密データを扱うには、Kubernetes Secret を使用します。

事前設定済みのシークレットを使用する

Helm チャートには、charts/clickstack/templates/secrets.yaml にあるデフォルトのシークレットテンプレートが含まれています。このファイルは、シークレットを管理するための基本的な構成を提供します。 シークレットを手動で適用する必要がある場合は、用意されている secrets.yaml テンプレートを編集して適用してください。
シークレットをクラスターに適用します:

カスタム Kubernetes Secret の作成

カスタム Kubernetes Secret を手動で作成します。

values.yaml で Secret を参照する

イングレスの設定

HyperDX UI と API をドメイン名経由で公開するには、values.yaml でイングレスを有効にします。

一般的なイングレスの設定

重要な設定上の注意hyperdx.frontendUrl はイングレスのホスト名と一致させ、プロトコル (例: https://hyperdx.yourdomain.com) を含める必要があります。これにより、生成されるすべてのリンク、Cookie、リダイレクトが正しく機能します。

TLS (HTTPS) の有効化

デプロイメントをHTTPSで保護するには: 1. 証明書と秘密鍵を含むTLSシークレットを作成します。
2. イングレスの設定でTLSを有効にします:

イングレス設定例

参考までに、生成されるイングレスリソースは次のようになります。

よくあるイングレスの落とし穴

パスと rewrite の設定:
  • Next.js やその他の SPA では、必ず上記のように正規表現のパスと rewrite アノテーションを使用してください
  • rewrite を設定せずに path: / だけを使うと、静的アセットを配信できなくなります
frontendUrlingress.host の不一致:
  • これらが一致していないと、Cookie、リダイレクト、アセットの読み込みで問題が発生することがあります
TLS の設定ミス:
  • TLS シークレットが有効で、イングレスから正しく参照されていることを確認してください
  • TLS が有効な状態で HTTP 経由でアプリにアクセスすると、ブラウザーが安全でないコンテンツをブロックすることがあります
イングレスコントローラーのバージョン:
  • 一部の機能 (正規表現パスや rewrite など) には、新しめの nginx ingress controller が必要です
  • 次のコマンドでバージョンを確認してください:

OTel collector イングレス

イングレス経由で OTel collector のエンドポイント (トレース、メトリクス、ログ) を公開する必要がある場合は、additionalIngresses 設定を使用します。これは、クラスター外からテレメトリーデータを送信する場合や、collector にカスタムドメインを使用する場合に便利です。
  • これにより、OTEL collector のエンドポイント用に個別のイングレスリソースが作成されます
  • 別のドメインを使用したり、特定の TLS 設定を構成したり、カスタム アノテーションを適用したりできます
  • 正規表現のパスルールを使うと、すべての OTLP シグナル (トレース、メトリクス、ログ) を 1 つのルールでルーティングできます
OTEL collector を外部に公開する必要がない場合は、この設定を省略できます。ほとんどのユーザーには、通常のイングレス設定で十分です。

イングレスのトラブルシューティング

イングレスリソースを確認します:
イングレスコントローラーのログを確認する:
アセット URL のテスト: curl を使って、静的アセットが HTML ではなく JavaScript として配信されていることを確認します。
ブラウザの DevTools:
  • 404 や、JS ではなく HTML を返しているアセットがないか、ネットワーク タブで確認します
  • コンソールで Unexpected token < のようなエラーを確認します (JS の代わりに HTML が返されていることを示します)
パスの書き換えを確認する:
  • イングレスがアセットのパスを削除したり、誤って書き換えたりしていないことを確認します
ブラウザと CDN cache をクリアする:
  • 変更後は、古いアセットが残らないように、ブラウザの cache と CDN/プロキシ cache をクリアします

values のカスタマイズ

--set フラグを使って設定をカスタマイズできます。
または、カスタムの values.yaml を作成します。デフォルトのvaluesを取得するには:
設定例:
カスタム values を適用します:

次のステップ

最終更新日 2026年7月2日