> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Managed ClickStack の利用を開始する

> Managed ClickStack の利用を開始する

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

開始する最も簡単な方法は、**ClickHouse Cloud** に **Managed ClickStack** をデプロイすることです。これにより、インジェスト、スキーマ、オブザーバビリティのワークフローを完全に制御したまま、完全マネージド型で安全なバックエンドを利用できます。ClickHouse を自分で運用する必要がなくなり、次のような利点が得られます。

* ストレージから独立したコンピュートの自動スケーリング
* オブジェクトストレージをベースにした、低コストかつ実質無制限の保持
* ウェアハウスによって、読み取りワークロードと書き込みワークロードを個別に分離可能
* 統合認証
* 自動バックアップ
* セキュリティ機能とコンプライアンス機能
* シームレスなアップグレード

<Steps>
  <Step title="ClickHouse Cloud に登録" id="signup-to-clickhouse-cloud">
    [ClickHouse Cloud](https://console.clickhouse.cloud) で Managed ClickStack サービスを作成するには、まず [ClickHouse Cloud クイックスタートガイド](/docs/ja/get-started/setup/cloud) の**最初のステップ**を完了してください。

    <Info>
      **Scale と Enterprise**

      ほとんどの ClickStack ワークロードには、この [Scale tier](/docs/ja/products/cloud/features/cloud-tiers) を推奨します。SAML、CMEK、HIPAA 準拠などの高度なセキュリティ機能が必要な場合は、Enterprise tier を選択してください。また、非常に大規模な ClickStack デプロイメント向けにカスタムのハードウェアプロファイルも利用できます。このような場合は、サポートにお問い合わせいただくことをお勧めします。
    </Info>

    Cloud プロバイダーとリージョンを選択します。

    <img src="https://mintcdn.com/private-7c7dfe99/MFPY913TqoHcFPXJ/images/clickstack/getting-started/region_resources.webp?fit=max&auto=format&n=MFPY913TqoHcFPXJ&q=85&s=68d7b3dec227b24b661d24a48071052a" alt="" width="1544" height="1322" data-path="images/clickstack/getting-started/region_resources.webp" />

    CPU とメモリを選択する際は、想定される ClickStack のインジェストスループットに基づいて見積もってください。以下の表は、これらのリソースをサイジングする際の目安です。

    | Monthly ingest volume | Recommended compute  |
    | --------------------- | -------------------- |
    | \< 10 TB / month      | 2 vCPU × 3 replicas  |
    | 10–50 TB / month      | 4 vCPU × 3 replicas  |
    | 50–100 TB / month     | 8 vCPU × 3 replicas  |
    | 100–500 TB / month    | 30 vCPU × 3 replicas |
    | 1 PB+ / month         | 59 vCPU × 3 replicas |

    これらの推奨値は、次の前提に基づいています。

    * データ量は、月あたりの**非圧縮インジェスト量**を指し、ログとトレースの両方に適用されます。
    * クエリパターンは、オブザーバビリティの一般的なユースケースを想定しており、ほとんどのクエリは**直近のデータ**、通常は過去 24 時間を対象とします。
    * インジェストは月全体を通して比較的**均一**であると想定しています。突発的なトラフィックやスパイクが見込まれる場合は、追加の余裕を持ってプロビジョニングしてください。
    * ストレージは ClickHouse Cloud のオブジェクトストレージで別途処理されるため、保持期間の制約要因にはなりません。長期間保持されるデータは、アクセス頻度が低いことを前提としています。

    より長い時間範囲を定期的にクエリするアクセスパターン、負荷の高い集計処理、または多数の同時利用ユーザーをサポートする場合は、さらに多くのコンピュートが必要になることがあります。

    特定のインジェストスループットに必要な CPU とメモリは 2 つのレプリカでも満たせますが、可能であれば、総容量を同等に保ちながらサービスの冗長性を高めるために 3 つのレプリカを使用することを推奨します。

    <Note>
      これらの値は**あくまで推定値**であり、初期ベースラインとして使用してください。実際に必要なリソースは、クエリの複雑さ、同時実行性、保持ポリシー、インジェストスループットのばらつきによって異なります。常にリソース使用状況を監視し、必要に応じてスケールしてください。
    </Note>

    要件を指定すると、Managed ClickStack サービスのプロビジョニングには数分かかります。プロビジョニングの完了を待つ間に、[ClickHouse Cloud console](/docs/ja/products/cloud/getting-started/intro) の他の部分もご覧ください。

    **プロビジョニングが完了すると、左側メニューの「ClickStack」オプションが有効になります**。
  </Step>

  <Step title="インジェストを設定" id="setup-ingestion">
    サービスのプロビジョニングが完了したら、対象のサービスが選択されていることを確認し、左側のメニューで "ClickStack" をクリックします。

    <img src="https://mintcdn.com/private-7c7dfe99/MFPY913TqoHcFPXJ/images/clickstack/getting-started/start_ingestion.webp?fit=max&auto=format&n=MFPY913TqoHcFPXJ&q=85&s=07c38948bb93f27ed1494e2305f59f36" alt="" width="3600" height="1890" data-path="images/clickstack/getting-started/start_ingestion.webp" />

    「Start Ingestion」を選択すると、インジェストソースを選択するよう求められます。Managed ClickStack では、主要なインジェストソースとして OpenTelemetry と [Vector](https://vector.dev/) をサポートしています。一方で、ユーザーは [ClickHouse Cloud でサポートされているインテグレーション](/docs/ja/integrations/home) のいずれかを使用して、独自のスキーマでデータを ClickHouse に直接送信することもできます。

    <img src="https://mintcdn.com/private-7c7dfe99/MFPY913TqoHcFPXJ/images/clickstack/getting-started/select_source.webp?fit=max&auto=format&n=MFPY913TqoHcFPXJ&q=85&s=5e93ae1c0751bddbc39aad878c5360d1" alt="" width="3600" height="1890" data-path="images/clickstack/getting-started/select_source.webp" />

    <Info>
      **OpenTelemetry を推奨**

      インジェスト形式として、OpenTelemetry の使用を強く推奨します。
      ClickStack で効率的に動作するよう特別に設計された、すぐに使えるスキーマが用意されており、最もシンプルで最適化された利用体験を提供します。
    </Info>

    <Tabs>
      <Tab title="OpenTelemetry">
        Managed ClickStack に OpenTelemetry データを送信するには、OpenTelemetry Collector を使用することを推奨します。collector は、アプリケーション (および他の collector) から OpenTelemetry データを受信し、ClickHouse Cloud に転送するゲートウェイとして機能します。

        まだ collector を実行していない場合は、以下の手順で起動してください。既存の collector がある場合は、設定例も用意されています。

        ### collector を起動する

        以下では、追加の処理を含み、ClickHouse Cloud 向けに最適化された、推奨構成である **ClickStack distribution of the OpenTelemetry Collector** を使用することを前提としています。独自の OpenTelemetry Collector を使用する場合は、["既存の collector を設定する。"](#configure-existing-collectors) を参照してください。

        すぐに開始するには、表示されている Docker コマンドをコピーして実行してください。

        <img src="https://mintcdn.com/private-7c7dfe99/MFPY913TqoHcFPXJ/images/clickstack/getting-started/otel_collector_start.webp?fit=max&auto=format&n=MFPY913TqoHcFPXJ&q=85&s=17d03c84272f9f39e33f28f38561375d" alt="" width="1452" height="408" data-path="images/clickstack/getting-started/otel_collector_start.webp" />

        このコマンドには、接続 credentials があらかじめ入力されています。

        <Info>
          **本番環境へのデプロイ**

          このコマンドでは Managed ClickStack への接続に `default` ユーザーを使用していますが、[本番環境に移行する](/docs/ja/clickstack/managing/production#create-a-database-ingestion-user-managed) 際は、専用ユーザーを作成し、設定を変更する必要があります。
        </Info>

        この 1 つのコマンドを実行すると、ポート 4317 (gRPC) および 4318 (HTTP) で OTLP endpoint を公開した ClickStack collector が起動します。すでに OpenTelemetry のインストルメンテーションと agent がある場合は、すぐにこれらの endpoint へのテレメトリー データ送信を開始できます。

        ### 既存の collector を設定する

        既存の OpenTelemetry Collectors を設定したり、独自の distribution の collector を使用したりすることも可能です。

        <Info>
          **ClickHouse exporter が必要**

          独自の distribution を使用する場合、たとえば [contrib image](https://github.com/open-telemetry/opentelemetry-collector-contrib) を使うなら、[ClickHouse exporter](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/clickhouseexporter) が含まれていることを確認してください。
        </Info>

        この用途のために、適切な設定で ClickHouse exporter を使用し、OTLP receiver を公開する OpenTelemetry Collector の設定例が提供されています。この設定は、ClickStack distribution で想定されているインターフェイスと動作に合わせています。

        以下にこの構成の例を示します (UIからコピーする場合、環境変数はあらかじめ入力された状態になります) :

        ```yaml theme={null}
        receivers:
          otlp/hyperdx:
            protocols:
              grpc:
                include_metadata: true
                endpoint: "0.0.0.0:4317"
              http:
                cors:
                  allowed_origins: ["*"]
                  allowed_headers: ["*"]
                include_metadata: true
                endpoint: "0.0.0.0:4318"
        processors:
          batch:
          memory_limiter:
            # 最大メモリの80%（上限2G）。メモリが少ない環境では調整してください
            limit_mib: 1500
            # 上限の25%（上限2G）。メモリが少ない環境では調整してください
            spike_limit_mib: 512
            check_interval: 5s
        connectors:
          routing/logs:
            default_pipelines: [logs/out-default]
            error_mode: ignore
            table:
              - context: log
                statement: route() where IsMatch(attributes["rr-web.event"], ".*")
                pipelines: [logs/out-rrweb]
        exporters:
          debug:
            verbosity: detailed
            sampling_initial: 5
            sampling_thereafter: 200
          clickhouse/rrweb:
            database: default
            endpoint: <clickhouse_cloud_endpoint>
            password: <your_password_here>
            username: default
            ttl: 720h
            logs_table_name: hyperdx_sessions
            timeout: 5s
            retry_on_failure:
              enabled: true
              initial_interval: 5s
              max_interval: 30s
              max_elapsed_time: 300s
          clickhouse:
            database: default
            endpoint: <clickhouse_cloud_endpoint>
            password: <your_password_here>
            username: default
            ttl: 720h
            timeout: 5s
            retry_on_failure:
              enabled: true
              initial_interval: 5s
              max_interval: 30s
              max_elapsed_time: 300s

        service:
          pipelines:
            traces:
              receivers: [otlp/hyperdx]
              processors: [memory_limiter, batch]
              exporters: [clickhouse]
            metrics:
              receivers: [otlp/hyperdx]
              processors: [memory_limiter, batch]
              exporters: [clickhouse]
            logs/in:
              receivers: [otlp/hyperdx]
              exporters: [routing/logs]
            logs/out-default:
              receivers: [routing/logs]
              processors: [memory_limiter, batch]
              exporters: [clickhouse]
            logs/out-rrweb:
              receivers: [routing/logs]
              processors: [memory_limiter, batch]
              exporters: [clickhouse/rrweb]

        ```

        <img src="https://mintcdn.com/private-7c7dfe99/MFPY913TqoHcFPXJ/images/clickstack/getting-started/otel_collector_start.webp?fit=max&auto=format&n=MFPY913TqoHcFPXJ&q=85&s=17d03c84272f9f39e33f28f38561375d" alt="" width="1452" height="408" data-path="images/clickstack/getting-started/otel_collector_start.webp" />

        OpenTelemetry collector の設定について詳しくは、["OpenTelemetry でインジェストする。"](/docs/ja/clickstack/ingesting-data/opentelemetry) を参照してください。

        ### インジェストを開始する (任意)

        OpenTelemetry でインストルメントする既存のアプリケーションやインフラストラクチャがある場合は、UI からリンクされている該当ガイドに進んでください。

        traces と logs を収集するようアプリケーションをインストルメントするには、[サポートされている言語 SDKs](/docs/ja/clickstack/ingesting-data/sdks/index) を使用してください。これらは、Managed ClickStack へのインジェスト用ゲートウェイとして動作する OpenTelemetry Collector にデータを送信します。

        logs は、agent モードで実行され、同じ collector にデータを転送する [OpenTelemetry Collectors を使用して収集](/docs/ja/clickstack/integration-examples/host-logs) できます。Kubernetes の監視については、[専用ガイド](/docs/ja/clickstack/integration-examples/kubernetes) を参照してください。その他のインテグレーションについては、[quickstart ガイド](/docs/ja/clickstack/integration-examples/index) を参照してください。

        ### デモデータ

        既存のデータがない場合は、サンプル dataset のいずれかを試すこともできます。

        * [Example dataset](/docs/ja/clickstack/example-datasets/sample-data) - 公開デモからサンプル dataset を読み込みます。単純な問題を診断できます。
        * [ローカルファイルとメトリクス](/docs/ja/clickstack/example-datasets/local-data) - ローカル OTel collector を使用してローカルファイルを読み込み、OSX または Linux 上でシステムを監視します。

        <br />
      </Tab>

      <Tab title="Vector">
        [Vector](https://vector.dev) は、高性能でベンダー中立なオブザーバビリティデータパイプラインであり、特にその柔軟性と少ないリソース消費から、ログのインジェストで広く利用されています。

        ClickStack で Vector を使用する場合、ユーザーは独自のスキーマを定義する必要があります。これらのスキーマは OpenTelemetry の規約に従うこともできますが、ユーザー定義のイベント構造を表す完全にカスタムなものにすることもできます。

        <Info>
          **Timestamp は必須**

          Managed ClickStack で唯一の必須要件は、データに **timestamp カラム** (または同等の時刻フィールド) が含まれていることです。これは ClickStack UI でログソースを設定する際に指定できます。
        </Info>

        以下では、インジェストパイプラインがあらかじめ設定され、データを送信している Vector のインスタンスがすでに稼働していることを前提とします。

        ### データベースとテーブルを作成する

        Vector では、データを取り込む前にテーブルとスキーマを定義しておく必要があります。

        まず、データベースを作成します。これは [ClickHouse Cloud console](/docs/ja/products/cloud/features/sql-console-features/sql-console) から実行できます。

        たとえば、ログ用のデータベースを作成します。

        ```sql theme={null}
        CREATE DATABASE IF NOT EXISTS logs
        ```

        次に、ログデータの構造に合ったスキーマを持つテーブルを作成します。以下の例では、一般的な Nginx のアクセスログ形式を前提としています。

        ```sql theme={null}
        CREATE TABLE logs.nginx_logs
        (
            `time_local` DateTime,
            `remote_addr` IPv4,
            `remote_user` LowCardinality(String),
            `request` String,
            `status` UInt16,
            `body_bytes_sent` UInt64,
            `http_referer` String,
            `http_user_agent` String,
            `http_x_forwarded_for` LowCardinality(String),
            `request_time` Float32,
            `upstream_response_time` Float32,
            `http_host` String
        )
        ENGINE = MergeTree
        ORDER BY (toStartOfMinute(time_local), status, remote_addr);
        ```

        テーブルは、Vector が生成する出力スキーマに合わせる必要があります。推奨される[スキーマのベストプラクティス](/docs/ja/concepts/best-practices/select-data-type)に従って、データに合わせて必要に応じてスキーマを調整してください。

        ClickHouse における[主キー](/docs/ja/concepts/core-concepts/primary-indexes)の仕組みを理解し、アクセスパターンに基づいてソートキーを選ぶことを強く推奨します。主キーの選び方については、[ClickStack 向け](/docs/ja/clickstack/managing/performance-tuning#choosing-a-primary-key)のガイダンスを参照してください。

        テーブルを作成したら、表示されている設定スニペットをコピーしてください。既存のパイプラインを利用するように input を調整し、必要に応じてターゲットテーブルとデータベースも変更してください。認証情報は事前に入力されているはずです。

        <img src="https://mintcdn.com/private-7c7dfe99/MFPY913TqoHcFPXJ/images/clickstack/getting-started/vector_config.webp?fit=max&auto=format&n=MFPY913TqoHcFPXJ&q=85&s=c82fea7d5dbaeb68c933f8955b72c550" alt="" width="3600" height="1890" data-path="images/clickstack/getting-started/vector_config.webp" />

        Vector を使ったデータ取り込みのその他の例については、["Vector で取り込む"](/docs/ja/clickstack/ingesting-data/vector)または高度なオプションについては [Vector ClickHouse sink documentation](https://vector.dev/docs/reference/configuration/sinks/clickhouse/) を参照してください。

        <br />
      </Tab>
    </Tabs>
  </Step>

  <Step title="ClickStack UI に移動" id="navigate-to-clickstack-ui-cloud">
    ClickStack UI (HyperDX) にアクセスするには、\[Launch ClickStack] を選択します。自動的に認証され、リダイレクトされます。

    <Tabs>
      <Tab title="OpenTelemetry">
        OpenTelemetry データ用のデータソースはあらかじめ作成されています。

        <img src="https://mintcdn.com/private-7c7dfe99/Xl4dVm4Z5MHG1h5Z/images/clickstack/getting-started/clickstack_managed_ui.webp?fit=max&auto=format&n=Xl4dVm4Z5MHG1h5Z&q=85&s=4dc572ec430f7fa935d92e5be15d18e1" alt="" width="3600" height="1870" data-path="images/clickstack/getting-started/clickstack_managed_ui.webp" />
      </Tab>

      <Tab title="Vector">
        Vector を使用している場合は、データソースを自分で作成する必要があります。初回ログイン時に作成を求められます。以下に、ログ用データソースの設定例を示します。

        <img src="https://mintcdn.com/private-7c7dfe99/Xl4dVm4Z5MHG1h5Z/images/clickstack/create-vector-datasource.webp?fit=max&auto=format&n=Xl4dVm4Z5MHG1h5Z&q=85&s=a224478e2f9b0b24fae81fbe3efd7a9d" alt="" width="3600" height="1938" data-path="images/clickstack/create-vector-datasource.webp" />

        この設定は、タイムスタンプとして `time_local` カラムを使用する Nginx 形式のスキーマを前提としています。可能であれば、このカラムには主キーで宣言されたタイムスタンプカラムを指定してください。**このカラムは必須です**。

        また、ログビューで返すカラムを明示的に定義するため、`Default SELECT` を更新することも推奨します。service name、log level、body カラムなどの追加フィールドが利用可能な場合は、それらも設定できます。タイムスタンプの表示カラムが、テーブルの主キーで使用され、上で設定したカラムと異なる場合は、それも上書きできます。

        上記の例では、データに `Body` カラムは存在しません。その代わり、利用可能なフィールドから Nginx のログ行を再構築する SQL expression を使って定義しています。

        その他のオプションについては、[configuration reference](/docs/ja/clickstack/managing/config) を参照してください。

        作成が完了すると、Search view に移動し、すぐにデータの確認を開始できます。

        <img src="https://mintcdn.com/private-7c7dfe99/Xl4dVm4Z5MHG1h5Z/images/clickstack/getting-started/clickstack_managed_ui.webp?fit=max&auto=format&n=Xl4dVm4Z5MHG1h5Z&q=85&s=4dc572ec430f7fa935d92e5be15d18e1" alt="" width="3600" height="1870" data-path="images/clickstack/getting-started/clickstack_managed_ui.webp" />
      </Tab>
    </Tabs>

    <br />

    以上で完了です。🎉

    さっそく ClickStack を活用してみましょう。ログやトレースを検索し、ログ・トレース・メトリクスの相関をリアルタイムで確認し、ダッシュボードを作成し、サービスマップを確認し、イベントデルタやパターンを見つけ、アラートを設定して問題を未然に把握できます。
  </Step>

  <Step title="次のステップ" id="next-steps">
    <Warning>
      **デフォルトの認証情報を記録**

      上記の手順でデフォルトの認証情報を記録していない場合は、サービスに移動して `Connect` を選択し、パスワードと HTTP/native エンドポイントを記録してください。これらの管理者認証情報は安全に保管し、以降のガイドで再利用できます。
    </Warning>

    <Image img="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/service_connect.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=2a4e5eaf1da489019468d5a732877cc2" size="lg" alt="Service Connect" border width="3200" height="2125" data-path="images/_snippets/service_connect.webp" />

    新しいユーザーのプロビジョニングや追加のデータソースの追加などを行うには、[Managed ClickStack のデプロイガイド](/docs/ja/clickstack/deployment/managed#additional-tasks) を参照してください。
  </Step>
</Steps>