docs(locadex): add translations

Author: locadex-agent[bot]

gt-lock.json

@@ -168,6 +168,18 @@ patterns または recent queries テーブル内の任意の行をクリック
 遅いパターンの診断に必要な情報はすべて、1 つの
 画面にまとまっています。
 
+## クエリインサイト API \{#api\}
+
+同じテレメトリーは、
+[ClickHouse Cloud OpenAPI](/cloud/managed-postgres/openapi#query-insights)を通じて
+プログラムからも利用できます。
+[低速パターン](#slow-patterns) テーブルは
+[list slow query patterns](https://clickhouse.com/docs/cloud/manage/api/swagger#tag/Postgres/operation/slowQueryPatternsGetList)
+エンドポイントに対応し、[詳細フライアウト](#detail) は
+[get slow query pattern](https://clickhouse.com/docs/cloud/manage/api/swagger#tag/Postgres/operation/slowQueryPatternGet)
+エンドポイントに対応しています。このエンドポイントは、1 つのパターンの集計メトリクスと
+その最近の実行結果を返します。
+
 ## 仕組み \{#how-it-works\}
 
 ### ネットワークに出る前に、Postgres で正規化 \{#how-normalized\}
@@ -206,5 +218,6 @@ ClickHouse に送信できます。ソースコードと issue は
 
 * [監視ダッシュボード](/cloud/managed-postgres/monitoring/dashboard) — 組み込みのリソースとアクティビティのチャート
 * [Prometheus エンドポイント](/cloud/managed-postgres/monitoring/prometheus) — ホストレベルのメトリクスを独自のオブザーバビリティスタックにスクレイプして取り込む
+* [Managed Postgres OpenAPI](/cloud/managed-postgres/openapi#query-insights) — 低速パターンと最近の実行をプログラムからクエリする
 * [拡張機能](/cloud/managed-postgres/extensions) — Managed Postgres インスタンスで利用できる拡張機能
 * [`pg_stat_ch` on GitHub](https://github.com/clickhouse/pg_stat_ch) — クエリインサイト を支えるオープンソースの拡張機能

i18n/jp/docusaurus-plugin-content-docs/current/cloud/managed-postgres/monitoring/query-insights.md

@@ -3,7 +3,7 @@ slug: /cloud/managed-postgres/openapi
 sidebar_label: 'OpenAPI'
 title: 'Managed Postgres OpenAPI'
 description: 'OpenAPI を使用して Managed Postgres サービスをプログラムで制御します'
-keywords: ['managed postgres', 'openapi', 'api', 'curl', 'チュートリアル', 'コマンドライン']
+keywords: ['managed postgres', 'openapi', 'api', 'curl', 'チュートリアル', 'コマンドライン', 'クエリインサイト', '低速クエリ']
 doc_type: 'guide'
 ---
 
@@ -280,8 +280,130 @@ curl -sX DELETE --user "$KEY_ID:$KEY_SECRET" \
 Prometheus 互換の 2 つのエンドポイントで、Managed Postgres サービスの CPU、メモリ、I/O、接続、
 およびトランザクションのメトリクスを公開します。1 つは組織内のすべてのサービスの
 メトリクスを返し、もう 1 つは単一のサービスのメトリクスを返します。
-設定については [Prometheus endpoint] ページを、メトリクスの完全な一覧については
-[metrics reference] を参照してください。
+設定については [Prometheus エンドポイント] ページを、メトリクスの完全な一覧については
+[メトリクス リファレンス] を参照してください。
+
+## クエリインサイト \{#query-insights\}
+
+cloud
+コンソールの [Query Insights] タブで利用されているステートメント単位のテレメトリーは、プログラムからも利用できます。2 つのエンドポイントにより、サービス上で最も遅い
+クエリパターンが公開されています。一方は影響度順にすべてのパターンを一覧表示し、もう一方は単一のパターンとその最近の実行結果を返します。
+
+### 遅いクエリパターンを一覧表示する \{#list-slow-query-patterns\}
+
+[スローパターン API] は、一定期間内に観測された最も遅いクエリ
+パターンの集計メトリクスを返します。この期間の指定は必須です。RFC 3339 のタイムスタンプとして
+`from_date` と `to_date` を渡してください。
+
+```bash
+FROM=2026-05-25T00:00:00Z
+TO=2026-05-26T00:00:00Z
+
+curl -s --user "$KEY_ID:$KEY_SECRET" \
+    "https://api.clickhouse.cloud/v1/organizations/$ORG_ID/postgres/$PG_ID/slowQueryPatterns?from_date=$FROM&to_date=$TO" \
+    | jq
+```
+
+結果はデフォルトで、`total_duration` の降順にソートされた、最も負荷の高いパターンから表示されます。`sort_by` を使うと別の項目 (たとえば
+`p99_duration`、`call_count`、または `total_wal_bytes`) でソートでき、`sort_order` で順序を反転できます。`db_name`、`db_user`、
+`db_operation`、`app` のフィルターで対象を絞り込み、`limit` と
+`offset` でページ送りできます。
+
+各結果は 1 つの正規化されたパターンで、リテラルは除去され、
+実行時間はマイクロ秒単位で表示されます:
+
+```json
+{
+  "result": [
+    {
+      "queryId": "-4748036479882663975",
+      "queryText": "SELECT * FROM orders WHERE customer_id = $1 ORDER BY created_at DESC LIMIT $2",
+      "dbName": "sales",
+      "dbUser": "orders_service",
+      "dbOperation": "SELECT",
+      "app": "orders-api",
+      "callCount": 84213,
+      "errorCount": 0,
+      "totalDurationUs": 1012384556,
+      "avgDurationUs": 12021,
+      "maxDurationUs": 482915,
+      "p50DurationUs": 9874,
+      "p95DurationUs": 28431,
+      "p99DurationUs": 41200,
+      "totalRows": 842130,
+      "totalSharedBlksRead": 19284,
+      "totalSharedBlksHit": 48217734,
+      "totalCpuTimeUs": 938472113,
+      "totalWalBytes": 0
+    }
+  ],
+  "requestId": "c128d830-5769-4c82-8235-f79aa69d1ebf",
+  "status": 200
+}
+```
+
+`queryId` は正規化されたステートメントの符号付き 64 ビットハッシュなので、
+負の値になることがよくあります。先頭の `-` も含めてそのまま渡すことで、
+1 つのパターンを取得できます。
+
+### 遅いクエリパターンを取得する \{#get-slow-query-pattern\}
+
+リストレスポンスの `queryId` を [slow pattern API] に渡すと、その
+パターンの集計メトリクスと直近の個別の実行結果を取得できます。
+パターンの識別に必要な `db_name`、`db_user`、`db_operation` は
+必須です:
+
+```bash
+QUERY_ID=-4748036479882663975
+
+curl -s --user "$KEY_ID:$KEY_SECRET" \
+    "https://api.clickhouse.cloud/v1/organizations/$ORG_ID/postgres/$PG_ID/slowQueryPatterns/$QUERY_ID?db_name=sales&db_user=orders_service&db_operation=SELECT" \
+    | jq
+```
+
+レスポンスには、一覧エンドポイントと同じ集計が
+`aggregate` に含まれ、それに加えて `recentExecutions` 配列が含まれます。各実行には、
+実行ごとの完全なカウンター — shared および temp block の I/O、CPU の user time と system
+time、parallel workers、JIT、WAL — が含まれており、これらは
+コンソールの [detail flyout] で内訳が表示されるものと同じカウンターです:
+
+```json
+{
+  "result": {
+    "aggregate": {
+      "queryId": "-4748036479882663975",
+      "queryText": "SELECT * FROM orders WHERE customer_id = $1 ORDER BY created_at DESC LIMIT $2",
+      "dbName": "sales",
+      "dbUser": "orders_service",
+      "dbOperation": "SELECT",
+      "callCount": 84213,
+      "avgDurationUs": 12021,
+      "p99DurationUs": 41200
+    },
+    "recentExecutions": [
+      {
+        "timestamp": "2026-05-25T16:42:09Z",
+        "durationUs": 41200,
+        "rows": 10,
+        "sharedBlksHit": 412,
+        "sharedBlksRead": 3,
+        "tempBlksWritten": 0,
+        "cpuUserTimeUs": 38211,
+        "cpuSysTimeUs": 1044,
+        "parallelWorkersPlanned": 0,
+        "parallelWorkersLaunched": 0,
+        "walBytes": 0,
+        "serverRole": "primary"
+      }
+    ]
+  },
+  "requestId": "a5957990-dbe5-46fd-b5ce-a7f8f79e50fe",
+  "status": 200
+}
+```
+
+この例では、簡潔さのために両方のオブジェクトを省略しています。API は
+[per-execution counters] に記載されている完全なカウンターセットを返します。
 
 [ClickHouse OpenAPI]: /cloud/manage/cloud-api "Cloud API"
 
@@ -309,4 +431,14 @@ Prometheus 互換の 2 つのエンドポイントで、Managed Postgres サー
 
 [Prometheus endpoint]: /cloud/managed-postgres/monitoring/prometheus "Managed Postgres の Prometheus エンドポイント"
 
-[metrics reference]: /cloud/managed-postgres/monitoring/metrics "Managed Postgres メトリクスリファレンス"
+[metrics reference]: /cloud/managed-postgres/monitoring/metrics "Managed Postgres メトリクスリファレンス"
+
+[Query Insights]: /cloud/managed-postgres/monitoring/query-insights "Postgres クエリインサイト"
+
+[detail flyout]: /cloud/managed-postgres/monitoring/query-insights#detail "クエリインサイトの詳細フライアウト"
+
+[per-execution counters]: /cloud/managed-postgres/monitoring/query-insights#counters "クエリインサイトの実行ごとのカウンター"
+
+[スローパターン API]: https://clickhouse.com/docs/cloud/manage/api/swagger#tag/Postgres/operation/slowQueryPatternsGetList "Postgres のスロークエリパターンを一覧表示"
+
+[slow pattern API]: https://clickhouse.com/docs/cloud/manage/api/swagger#tag/Postgres/operation/slowQueryPatternGet "直近の実行を含む Postgres のスロークエリパターンを取得"

i18n/jp/docusaurus-plugin-content-docs/current/cloud/managed-postgres/openapi.md

@@ -170,6 +170,18 @@ Application, Blks hit, CPU user, CPU sys, PID를 추가할 수 있습니다. 이
 느린 패턴을 진단하는 데 필요한 모든 정보를 한곳, 한 화면에서
 확인할 수 있습니다.
 
+## 쿼리 인사이트 API \{#api\}
+
+동일한 텔레메트리 데이터는
+[ClickHouse Cloud OpenAPI](/cloud/managed-postgres/openapi#query-insights)를 통해
+프로그래밍 방식으로도 사용할 수 있습니다.
+[느린 패턴](#slow-patterns) 테이블은
+[list slow query patterns](https://clickhouse.com/docs/cloud/manage/api/swagger#tag/Postgres/operation/slowQueryPatternsGetList)
+엔드포인트에 해당하며, [세부 정보 플라이아웃](#detail)은
+[get slow query pattern](https://clickhouse.com/docs/cloud/manage/api/swagger#tag/Postgres/operation/slowQueryPatternGet)
+엔드포인트에 해당합니다. 이 엔드포인트는 단일 패턴의 집계 메트릭과
+최근 실행 내역을 함께 반환합니다.
+
 ## 작동 원리 \{#how-it-works\}
 
 ### 전송 전에 Postgres에서 정규화됩니다 \{#how-normalized\}
@@ -211,5 +223,6 @@ ClickHouse로 전송할 수 있습니다. 소스 코드와 이슈는
 
 * [모니터링 대시보드](/cloud/managed-postgres/monitoring/dashboard) — 기본 제공되는 리소스 및 활동 차트
 * [Prometheus 엔드포인트](/cloud/managed-postgres/monitoring/prometheus) — 호스트 수준 메트릭을 자체 관측성 스택으로 스크레이프
+* [Managed Postgres OpenAPI](/cloud/managed-postgres/openapi#query-insights) — 느린 패턴과 최근 실행 내역을 프로그래밍 방식으로 조회
 * [확장 기능](/cloud/managed-postgres/extensions) — Managed Postgres 인스턴스에서 사용할 수 있는 확장 기능
 * [`pg_stat_ch` on GitHub](https://github.com/clickhouse/pg_stat_ch) — 쿼리 인사이트를 구동하는 오픈소스 확장 기능

i18n/ko/docusaurus-plugin-content-docs/current/cloud/managed-postgres/monitoring/query-insights.md

@@ -3,7 +3,7 @@ slug: /cloud/managed-postgres/openapi
 sidebar_label: 'OpenAPI'
 title: 'Managed Postgres OpenAPI'
 description: 'OpenAPI로 Managed Postgres 서비스를 제어할 수 있습니다'
-keywords: ['managed postgres', 'openapi', 'api', 'curl', '튜토리얼', '명령줄']
+keywords: ['managed postgres', 'openapi', 'api', 'curl', '튜토리얼', '명령줄', '쿼리 인사이트', '느린 쿼리']
 doc_type: 'guide'
 ---
 
@@ -285,8 +285,129 @@ curl -sX DELETE --user "$KEY_ID:$KEY_SECRET" \
 Prometheus와 호환되는 2개의 엔드포인트가 Managed Postgres 서비스의 CPU, 메모리, I/O, 연결,
 및 트랜잭션 메트릭을 노출합니다. 하나는 조직의 모든 서비스에 대한
 메트릭을 반환하고, 다른 하나는 단일 서비스에 대한 메트릭을 반환합니다.
-설정 방법은 [Prometheus endpoint] 페이지를, 전체 메트릭 목록은
-[metrics reference]를 참조하십시오.
+설정 방법은 [Prometheus 엔드포인트] 페이지를, 전체 메트릭 목록은
+[메트릭 참고]를 참조하십시오.
+
+## 쿼리 인사이트 \{#query-insights\}
+
+Cloud Console의 [쿼리 인사이트] 탭에서 제공되는 SQL 문별 텔레메트리는 프로그래밍 방식으로도 사용할 수 있습니다. 2개의 엔드포인트가 서비스의 가장 느린 쿼리 패턴을 제공합니다. 하나는 영향도 순으로 모든 패턴을 나열하고, 다른 하나는 최근 실행 내역과 함께 단일 패턴을 반환합니다.
+
+### 느린 쿼리 패턴 목록 \{#list-slow-query-patterns\}
+
+[slow patterns API]는 지정된 시간 범위 동안 관찰된 가장 느린 쿼리
+패턴의 집계 메트릭을 반환합니다. 시간 범위는 필수이므로
+RFC 3339 타임스탬프 형식의 `from_date`와 `to_date`를 전달하십시오:
+
+```bash
+FROM=2026-05-25T00:00:00Z
+TO=2026-05-26T00:00:00Z
+
+curl -s --user "$KEY_ID:$KEY_SECRET" \
+    "https://api.clickhouse.cloud/v1/organizations/$ORG_ID/postgres/$PG_ID/slowQueryPatterns?from_date=$FROM&to_date=$TO" \
+    | jq
+```
+
+결과는 기본적으로 `total_duration` 내림차순으로 정렬되며, 비용이 높은 패턴이 먼저 표시됩니다. `sort_by`로 다른 카운터(예:
+`p99_duration`, `call_count`, `total_wal_bytes`)를 기준으로 정렬할 수 있고, `sort_order`로 정렬 방향을
+반대로 바꿀 수 있습니다. `db_name`, `db_user`,
+`db_operation`, `app` 필터로 범위를 좁히고, `limit` 및
+`offset`으로 페이지를 나눠 볼 수 있습니다.
+
+각 결과는 리터럴이 제거된 정규화된 패턴 1개이며, 지속 시간은 마이크로초 단위로
+표시됩니다:
+
+```json
+{
+  "result": [
+    {
+      "queryId": "-4748036479882663975",
+      "queryText": "SELECT * FROM orders WHERE customer_id = $1 ORDER BY created_at DESC LIMIT $2",
+      "dbName": "sales",
+      "dbUser": "orders_service",
+      "dbOperation": "SELECT",
+      "app": "orders-api",
+      "callCount": 84213,
+      "errorCount": 0,
+      "totalDurationUs": 1012384556,
+      "avgDurationUs": 12021,
+      "maxDurationUs": 482915,
+      "p50DurationUs": 9874,
+      "p95DurationUs": 28431,
+      "p99DurationUs": 41200,
+      "totalRows": 842130,
+      "totalSharedBlksRead": 19284,
+      "totalSharedBlksHit": 48217734,
+      "totalCpuTimeUs": 938472113,
+      "totalWalBytes": 0
+    }
+  ],
+  "requestId": "c128d830-5769-4c82-8235-f79aa69d1ebf",
+  "status": 200
+}
+```
+
+`queryId`는 정규화된 SQL 문(statement)의 부호 있는 64비트 해시이므로
+대개 음수입니다. 단일 패턴을 가져오려면 앞의 `-`를 포함해
+값을 그대로 다시 전달하십시오.
+
+### 느린 쿼리 패턴 가져오기 \{#get-slow-query-pattern\}
+
+목록 응답의 `queryId`를 [slow pattern API]에 전달하면 해당
+패턴의 집계 메트릭과 함께 가장 최근의 개별 실행 기록을 가져올 수 있습니다.
+패턴을 식별하는 `db_name`, `db_user`, `db_operation`은
+필수입니다:
+
+```bash
+QUERY_ID=-4748036479882663975
+
+curl -s --user "$KEY_ID:$KEY_SECRET" \
+    "https://api.clickhouse.cloud/v1/organizations/$ORG_ID/postgres/$PG_ID/slowQueryPatterns/$QUERY_ID?db_name=sales&db_user=orders_service&db_operation=SELECT" \
+    | jq
+```
+
+응답에는 목록 엔드포인트와 동일한 집계가 `aggregate` 아래에 포함되며,
+여기에 `recentExecutions` 배열이 추가됩니다. 각 실행에는
+공유 및 임시 블록 I/O, CPU 사용자 및 시스템
+시간, 병렬 workers, JIT, WAL을 비롯한 실행별 전체 카운터가 포함되며, 이는
+콘솔에서 [detail flyout]이 세부적으로 보여주는 카운터와 동일합니다:
+
+```json
+{
+  "result": {
+    "aggregate": {
+      "queryId": "-4748036479882663975",
+      "queryText": "SELECT * FROM orders WHERE customer_id = $1 ORDER BY created_at DESC LIMIT $2",
+      "dbName": "sales",
+      "dbUser": "orders_service",
+      "dbOperation": "SELECT",
+      "callCount": 84213,
+      "avgDurationUs": 12021,
+      "p99DurationUs": 41200
+    },
+    "recentExecutions": [
+      {
+        "timestamp": "2026-05-25T16:42:09Z",
+        "durationUs": 41200,
+        "rows": 10,
+        "sharedBlksHit": 412,
+        "sharedBlksRead": 3,
+        "tempBlksWritten": 0,
+        "cpuUserTimeUs": 38211,
+        "cpuSysTimeUs": 1044,
+        "parallelWorkersPlanned": 0,
+        "parallelWorkersLaunched": 0,
+        "walBytes": 0,
+        "serverRole": "primary"
+      }
+    ]
+  },
+  "requestId": "a5957990-dbe5-46fd-b5ce-a7f8f79e50fe",
+  "status": 200
+}
+```
+
+예시에서는 간결하게 보여주기 위해 두 객체를 모두 일부만 표시했으며, API는
+[per-execution counters]에 문서화된 전체 카운터 세트를 반환합니다.
 
 [ClickHouse OpenAPI]: /cloud/manage/cloud-api "Cloud API"
 
@@ -314,4 +435,14 @@ Prometheus와 호환되는 2개의 엔드포인트가 Managed Postgres 서비스
 
 [Prometheus endpoint]: /cloud/managed-postgres/monitoring/prometheus "Managed Postgres Prometheus 엔드포인트"
 
-[metrics reference]: /cloud/managed-postgres/monitoring/metrics "Managed Postgres 메트릭 참고"
+[metrics reference]: /cloud/managed-postgres/monitoring/metrics "Managed Postgres 메트릭 참고"
+
+[Query Insights]: /cloud/managed-postgres/monitoring/query-insights "Postgres 쿼리 인사이트"
+
+[detail flyout]: /cloud/managed-postgres/monitoring/query-insights#detail "쿼리 인사이트 세부 정보 플라이아웃"
+
+[per-execution counters]: /cloud/managed-postgres/monitoring/query-insights#counters "쿼리 인사이트 실행별 카운터"
+
+[slow patterns API]: https://clickhouse.com/docs/cloud/manage/api/swagger#tag/Postgres/operation/slowQueryPatternsGetList "Postgres 느린 쿼리 패턴 목록 조회"
+
+[slow pattern API]: https://clickhouse.com/docs/cloud/manage/api/swagger#tag/Postgres/operation/slowQueryPatternGet "최근 실행 기록과 함께 Postgres 느린 쿼리 패턴 조회"