hyperdx: ブロック配下で Kubernetes のリソースタイプごとに整理されています:
envFrom を介して HyperDX デプロイメント および OTel collector で共有される、2 つの固定名リソースを通して渡されます。
clickstack-configConfigMap —hyperdx.configから生成されますclickstack-secretSecret —hyperdx.secretsから生成されます
- 設定済みのイングレスまたはサービスのエンドポイントから HyperDX インスタンスにアクセス します
- HyperDX ダッシュボードにログインし、Team settings に移動して API キーを生成または取得します
- 次のいずれかの方法で、API キーを使用して デプロイメントを更新 します:
values.yaml に API キーを追加します:
このチャートは、設定値を格納した Kubernetes Secret (
clickstack-secret) を自動的に作成します。外部の Secret を使用する場合を除き、追加の Secret 設定は不要です。hyperdx.secrets から生成される統一的な clickstack-secret リソースが提供されています。
このチャートには、すべてのシークレットにデフォルト値が用意されています。values.yaml で上書きしてください。
values.yaml でイングレスを有効にします。
重要な設定上の注意
hyperdx.frontendUrl はイングレスのホスト名と一致し、プロトコル (例: https://hyperdx.yourdomain.com) を含める必要があります。これにより、生成されるリンク、Cookie、リダイレクトがすべて正しく機能します。- Next.js やその他の SPA では、必ず上記のように正規表現パスとリライト用のアノテーションを使用してください
- リライトなしで
path: /だけを使用すると、静的アセットを正しく配信できなくなります
frontendUrl と ingress.host の不一致:
- これらが一致していないと、Cookie、リダイレクト、アセットの読み込みに問題が発生することがあります
- TLS シークレットが有効であり、イングレスで正しく参照されていることを確認してください
- TLS が有効な状態で HTTP 経由でアプリにアクセスすると、ブラウザが安全でないコンテンツをブロックすることがあります
- 一部の機能 (正規表現パスやリライトなど) を使うには、比較的新しいバージョンの nginx ingress controller が必要です
- 次のコマンドでバージョンを確認してください:
additionalIngresses 設定を使用します。これは、クラスター外からテレメトリーデータを送信する場合や、collector にカスタムドメインを使用する場合に便利です。
- これにより、OTel collector のエンドポイント用に個別のイングレスリソースが作成されます
- 別のドメインを使用したり、TLS の詳細設定を行ったり、カスタムアノテーションを適用したりできます
- 正規表現のパスルールを使うことで、すべての OTLP シグナル (トレース、メトリクス、ログ) を 1 つのルールでルーティングできます
OTel collector を外部公開する必要がなければ、この設定は省略できます。ほとんどの場合、一般的なイングレス設定で十分です。
additionalManifests を使って、AWS ALB Ingress などの完全にカスタムなイングレスリソースを定義することもできます。
OTel collector は、公式の OpenTelemetry Collector Helm チャートの otel-collector: サブチャートとしてデプロイされます。values では、otel-collector: の直下で直接設定してください。
clickstack-config ConfigMap と clickstack-secret Secret を介して共有されます。サブチャートの extraEnvsFrom は、あらかじめその両方を参照するようになっています。
利用可能なすべてのサブチャート値については、OpenTelemetry Collector Helm チャートを参照してください。
MongoDB は、MongoDBCommunity カスタムリソースを通じて MCK operator によって管理されます。CR スペックは mongodb.spec の内容がそのまま反映されます:
hyperdx.secrets.MONGODB_PASSWORD で設定します。使用可能なすべての CRD フィールドについては、MCK ドキュメント を参照してください。
ClickHouse は、ClickHouseCluster および KeeperCluster のカスタムリソースを通じて、ClickHouse Operator によって管理されます。両方の CR スペックは、values からそのままレンダリングされます。
hyperdx.secrets から取得されます (v1.x のように clickhouse.config.users から取得されるわけではありません) 。利用可能なすべての CRD フィールドについては、ClickHouse Operator 構成ガイド を参照してください。
イングレスリソースを確認する:
curl を使って、静的アセットが HTML ではなく JS として配信されていることを確認します。
- 404 や、JS ではなく HTML を返しているアセットがないか、ネットワーク タブで確認します
- コンソールで
Unexpected token <のような error を探します (JS の代わりに HTML が返されていることを示します)
- イングレスがアセットのパスを取り除いたり、誤って書き換えたりしていないことを確認します
- 変更後は、古いアセットが使われないように、ブラウザの cache と CDN/プロキシ cache をクリアします
--set フラグを使用して設定をカスタマイズできます:
values.yaml を作成します。デフォルト値を取得するには、次のようにします。
- デプロイオプション - 外部システムと最小構成のデプロイ
- Cloud デプロイメント - GKE、EKS、AKS の構成
- アップグレードガイド - v1.x から v2.x への移行
- 追加マニフェスト - カスタム Kubernetes オブジェクト
- Helm メインガイド - 基本インストール
- 設定 (v1.x) - v1.x の設定ガイド