API キーの設定
- 設定済みのイングレスまたはサービスのエンドポイント から HyperDX インスタンスにアクセス します
- HyperDX ダッシュボードにログイン し、Team Settings に移動して API キーを生成または取得します
- 以下のいずれかの方法で、API キーを使用してデプロイメントを更新 します:
方法1: valuesファイルを使って Helm upgrade で更新
values.yaml に API キー を追加します:
方法 2: —set フラグを指定して Helm upgrade で更新
変更を反映するためにポッドを再起動する
この チャート は、API キー を含む Kubernetes Secret (
<release-name>-app-secrets) を自動的に作成します。外部 Secret を使用する場合を除き、追加の Secret 設定は不要です。シークレット管理
事前設定済みのシークレットを使用する
charts/clickstack/templates/secrets.yaml にあるデフォルトのシークレットテンプレートが含まれています。このファイルは、シークレットを管理するための基本的な構成を提供します。
シークレットを手動で適用する必要がある場合は、用意されている secrets.yaml テンプレートを編集して適用してください。
カスタム Kubernetes Secret の作成
values.yaml で Secret を参照する
イングレスの設定
values.yaml でイングレスを有効にします。
一般的なイングレスの設定
重要な設定上の注意
hyperdx.frontendUrl はイングレスのホスト名と一致させ、プロトコル (例: https://hyperdx.yourdomain.com) を含める必要があります。これにより、生成されるすべてのリンク、Cookie、リダイレクトが正しく機能します。TLS (HTTPS) の有効化
イングレス設定例
よくあるイングレスの落とし穴
- Next.js やその他の SPA では、必ず上記のように正規表現のパスと rewrite アノテーションを使用してください
- rewrite を設定せずに
path: /だけを使うと、静的アセットを配信できなくなります
frontendUrl と ingress.host の不一致:
- これらが一致していないと、Cookie、リダイレクト、アセットの読み込みで問題が発生することがあります
- TLS シークレットが有効で、イングレスから正しく参照されていることを確認してください
- TLS が有効な状態で HTTP 経由でアプリにアクセスすると、ブラウザーが安全でないコンテンツをブロックすることがあります
- 一部の機能 (正規表現パスや rewrite など) には、新しめの nginx ingress controller が必要です
- 次のコマンドでバージョンを確認してください:
OTel collector イングレス
additionalIngresses 設定を使用します。これは、クラスター外からテレメトリーデータを送信する場合や、collector にカスタムドメインを使用する場合に便利です。
- これにより、OTEL collector のエンドポイント用に個別のイングレスリソースが作成されます
- 別のドメインを使用したり、特定の TLS 設定を構成したり、カスタム アノテーションを適用したりできます
- 正規表現のパスルールを使うと、すべての OTLP シグナル (トレース、メトリクス、ログ) を 1 つのルールでルーティングできます
OTEL collector を外部に公開する必要がない場合は、この設定を省略できます。ほとんどのユーザーには、通常のイングレス設定で十分です。
イングレスのトラブルシューティング
curl を使って、静的アセットが HTML ではなく JavaScript として配信されていることを確認します。
404や、JS ではなく HTML を返しているアセットがないか、ネットワークタブで確認します- コンソールで
Unexpected token <のようなエラーを確認します (JS の代わりに HTML が返されていることを示します)
- イングレスがアセットのパスを削除したり、誤って書き換えたりしていないことを確認します
- 変更後は、古いアセットが残らないように、ブラウザの cache と CDN/プロキシ cache をクリアします
values のカスタマイズ
--set フラグを使って設定をカスタマイズできます。
values.yaml を作成します。デフォルトのvaluesを取得するには:
次のステップ
- デプロイ オプション (v1.x) - 外部システムと最小構成のデプロイメント
- Cloud デプロイメント (v1.x) - GKE、EKS、AKS 向けの構成
- Helm ガイド (v1.x) - 基本インストール
- Helm 設定 (v2.x) - v2.x の設定ガイド
- アップグレードガイド - v1.x から v2.x への移行