Openflowコネクタダッシュボードを使用したコネクタのモニター¶
Openflowコネクタダッシュボードは、インストールされているすべてのコネクタ、正常性スナップショット、およびフィルター条件に一致するすべてのコネクタによってインジェストされたデータの合計や集計平均スループットなどの主要なパフォーマンス指標の概要を提供します。
前提条件¶
Openflowコネクタダッシュボードを使用するには、次の前提条件を満たしている必要があります。
イベントテーブルに対する読み取り専用権限が少なくとも必要です。
以下のOpenflowの最小バージョンが必要です。
BYOC デプロイ:1.36.0
Snowflakeのデプロイ:1.26.0
ランタイム:2026.3.17.13
以下の最小コネクタバージョンが必要です。これらのバージョンは、変更データキャプチャ(CDC)コネクタのみに適用されます。他のコネクタタイプには、ダッシュボードをサポートするための最小バージョン要件はありません。
コネクタ
最小バージョン
MySQL
0.33.0
PostgreSQL
0.39.0
MongoDB
0.17.0
SQL サーバー
0.27.0
Oracle埋め込みライセンス
0.25.0
Oracle独立ライセンス
0.24.0
詳細については、 Snowflake Openflowのバージョン履歴 をご参照ください。
Openflowコネクタダッシュボードにアクセスする¶
Snowsight にサインインします。
ナビゲーションメニューで Ingestion`|raa|:ui:`Openflow を選択し、 Connector Observability タブに移動します。
Openflowコネクタダッシュボードが表示されます。
Openflowコネクタダッシュボードの概要¶
Openflowコネクタダッシュボードには、次の情報が表示されます。
- Status
次のステータスを持つコネクタの数を表示します。
Healthy:選択した期間中にエラーが発生しませんでした。
Unhealthy:選択した期間中にイベントテーブルのエラーをログに記録したか、1つ以上のテーブルが Failed 状態になっています(変更データキャプチャ(CDC)コネクタのみ)
Upgrade required:Openflowのデプロイ、ランタイム、またはコネクタは、健全性とパフォーマンスのメトリックを表示するために最低限必要なバージョンを実行していません。バージョンの前提条件を確認し、必要に応じてアップグレードします。
- Average throughput
ソースシステムからデータが読み込まれ、すべてのコネクタにわたってSnowflakeに送信されるレートを測定します。
Average throughput`|raa|:ui:`Ingested メトリックは、主なフィルター基準(時間枠とイベントテーブル)に一致するすべてのコネクタにわたって、Snowflakeにデータがどのように高速に送信されるかを測定します。
Average throughput`|raa|:ui:`Read メトリックは、プライマリフィルター基準(時間枠とイベントテーブル)に一致するすべてのコネクタ全体で、Openflowがソースシステムからデータを読み取る高速性を測定します。
- Total data ingested
選択した期間中に、時間枠とイベントテーブルの主なフィルター条件に一致するすべてのコネクタがSnowflakeに送信したデータの量を表示します。このメトリックを使用して、特定の期間におけるインジェスチョンの異常をすばやく特定します。
ダッシュボードを超えたカスタムテレメトリクエリについては、 テレメトリーデータを使ったOpenflowの監視 をご参照ください。
注釈
Total data ingested および Average throughput メトリックには、生のペイロードと、 JSON キー、中括弧、区切り文字などの構造的オーバーヘッドの両方が含まれます。これらのメトリックは送信量の合計を追跡するため、これらの数値はSnowpipe Streamingによって報告される非圧縮データや、宛先テーブルの最終的なストレージボリュームよりも大きくなる可能性があります。
コネクタが選択したフィルター基準に一致し、選択した時間枠中にテレメトリーイベントを記録した場合、コネクタはリストに表示されます。
より長い期間を調べると、以前に削除されたコネクタがリストに表示される場合があります。
たとえば、6日前にコネクタをデプロイし、2日前にそのコネクタを削除したとします。時間枠を Last 7 days に設定した場合、コネクタは過去7日間にテレメトリーイベントを記録したため、リストに表示されます。
コネクタのフィルタリング¶
Openflowコネクタダッシュボードは、次のフィルタをサポートしています。
- Event table
モニターしたいOpenflowコネクタのイベントテーブル。このフィルターは、デフォルトのイベントテーブルとアカウントイベントテーブルだけでなく、少なくとも1つのOpenflowデプロイメントに関連付けられたイベントテーブルを表示します。一度に選択できるイベントテーブルは1つだけです。イベントテーブルビューもサポートされています。
イベントテーブルは、Openflowを設定すると設定されます。
Tip
Openflowのデプロイに関連するイベントテーブルを表示するには、 DESCRIBE OPENFLOW DATA PLANE INTEGRATION コマンドを使用します。イベントテーブルの構成の詳細については、 :doc:` Openflowの設定: Snowflakeのデプロイ</user-guide/data-integration/openflow/setup-openflow-spcs-deployment>` または Openflowの設定 - BYOC をご参照ください。
- 時間枠
このフィルターを使用して、特定の時間枠にある関連コネクタを識別します。
Tip
コネクタの健全性に関する最新の結果を取得するには、 Last Hour 期間を選択します。
- Status
Healthy、 Unhealthy または All コネクタのフィルタリングを有効にします。
- Source
既知のデプロイ済みコネクタに基づいて、ソースシステムによるフィルタリングを有効にします。フィルターには、コネクタで使用されるソースのみが表示されます。
- Deployment
Snowflake Openflowのデプロイによるフィルタリングを有効にします。
このフィルターは、
OPENFLOW_DATAPLANE_という接頭辞に続いてデプロイ ID で構成されるデータプレーン統合名を表示します。デプロイ ID を見つけるにはOpenflowに移動し、 Deployments タブを選択し、次に View Details を選択します。- Runtime
Snowflake Openflowランタイムによるフィルタリングを有効にします。
このフィルターはランタイムキーを表示します。UI でランタイムキーとOpenflowランタイム名を一致させるには、Openflowに移動し、 Runtimes タブを選択し、次に View Details を選択して対応するキーを見つけます。
- Type
コネクタタイプによるフィルタリングを有効にします。データベース、 SaaS、ストリーミング、非構造化、その他。
注釈
プライマリフィルター(イベントテーブルと時間フレーム)は、セカンダリフィルター(ステータス、ソース、デプロイ、ランタイム、またはタイプ)の前に適用されます。
セカンダリフィルター(ステータス、ソース、デプロイ、ランタイム、タイプ)は、スループットとデータ取り込み済みのビジュアルには適用されません。
Openflowコネクタのモニター¶
コネクタの詳細をモニターするには、 |vertical-more-icon||raa|View Details を選択します。
変更データキャプチャコネクタ¶
詳細ページには、変更データキャプチャ構成の一部である各テーブルの次の情報が表示されます。
- Table replication status
テーブルは Active または Failed 複製ステータスのいずれかになります。複製ステータスは、テーブルで使用可能な最新のテレメトリーイベントに基づいています。テーブルの複製に失敗するイベントが発生した場合、ダッシュボードには即座に Failed 複製ステータスが表示されます。問題を特定するには Failure Reason メッセージを使用します。
- Error distribution
コネクタに問題が発生した時期を理解して、ソースシステム、コネクタの構成、またはSnowflakeの宛先に潜在的な問題を特定できるようにします。
- Table name
コネクタによって複製されるように構成されているすべてのテーブルのスキーマとテーブル名を表示します。リストはコネクタの Included Table Names または Included Table Regex 構成パラメーターに一致します。
- Replication status
各テーブルが Active または Failed 複製ステータスにあるかどうかを示します。
- Replication phase
現在のテーブル複製フェーズを表示します。コネクタでの構成後、テーブルは New 複製フェーズに入り、 Snapshot Load フェーズに進行し、初期ロードを実行、個々の変更データキャプチャイベントが処理されると最終的に Incremental Replication フェーズに入ります。
- Last Ingested
選択した時間枠中に宛先テーブルに最後に挿入された記録のタイムスタンプを表示します。このメトリックを見るときは、記録がインジェストされてから、イベントがログに記録されてクエリに使用可能になるまでの短い遅延を考慮してください。
テーブルリストを絞り込むには Replication status、 Replication phase、時間枠フィルターを使用できます。
すべてのコネクタ¶
- Connector status
コネクタの健全性ステータスを表示します。選択した時間枠中にエラーメッセージが発生しなかった場合は Healthy 、エラーメッセージが発生した場合は Unhealthy。
- Error distribution
選択した期間中にこのコネクタが発生したエラーの数を表示します。
- Average throughput
選択したコネクタについてソースシステムからデータが読み込まれ、Snowflakeに取り込まれる速度を測定します。
Average throughput`|raa|:ui:`Ingested メトリックは、選択したコネクタがSnowflakeにデータを取り込む速度を測定します。
Average throughput`|raa|:ui:`Read メトリックは、選択したコネクタがソースシステムからデータを読み取る速度を測定します。
- Total data ingested
選択した期間中に選択したコネクタがSnowflakeに取り込んだデータの量を表示します。このメトリックを使用して、特定の期間におけるインジェスチョンの異常をすばやく特定します。
カスタムフロー¶
Openflowキャンバス上に構築されたカスタムフローは、ダッシュボード上でも監視できますが、Openflow Git統合を使用して、顧客のGitリポジトリでアクティブにバージョン管理されている場合のみです。バージョン管理されていないフローはダッシュボードには表示されません。
詳細については、 カスタムフローのバージョン管理 をご参照ください。
Openflowコネクタのデバッグ¶
Openflowコネクタダッシュボードは、コネクタ固有の問題をデバッグするためのエントリポイントとして機能し、ユーザーがすべてのコネクタログに簡単にアクセスできるようにします。
コネクタエラーの表示¶
選択した時間枠内にコネクタで発生したすべてのエラーを表示するには、まず |vertical-more-icon||raa|View Details を選択してコネクタの詳細ページに移動し、次に Issues タブを選択します。
エラータイトルはコネクタで発生したエラーの種類を示し、コンテンツはエラーのスタックトレース全体を提供します。
コネクタログの表示¶
また、追加のコネクタログを参照して、エラーメッセージの前後のコンテキストを理解することもできます。選択したコネクタのすべてのログを表示するには、 |vertical-more-icon||raa|View logs を選択します。
ログエクスプローラーを開いた後、フィルターを変更して、異なるコネクタまたはランタイムまたはデプロイ全体のログを表示することもできます。ログエクスプローラーは、データプレーン ID、ランタイムキー、プロセスグループ ID のようなOpenflow固有のフィルターをサポートします。
Openflowキャンバスへのアクセス¶
コネクタの問題を特定した場合、それを修正するためにOpenflowキャンバスに移動する必要があります。たとえば、いくつかの構成パラメーターを調整したり、新しいコネクタバージョンにアップグレードしたりします。
Openflowキャンバスで選択したコネクタに移動するには、 |vertical-more-icon||raa|Go to canvas を選択します。
パフォーマンスの最適化¶
より大きなウェアハウスを選択します¶
画面右上のウェアハウスセレクターを使用して、クエリを実行する別のウェアハウスを選択します。
注釈
大規模なウェアハウスではクエリの実行が高速ですが、再開に時間がかかるため、初期ページのロード時間が長くなる可能性があります。
Openflowイベントテーブルでクラスタリングを設定する¶
このクラスタリングキーを活用して、クエリ中のマイクロパーティションの不要なスキャンを回避し、これらの列を参照するクエリのパフォーマンスを大幅に向上させます。詳細については、 データクラスタリングとは をご参照ください。
プレースホルダーをOpenflowイベントテーブルに置き換えて、以下のクエリを実行します。
注釈
自動クラスタリングは、サーバーレスコンピューティングリソースを使用してSnowflakeクレジットを消費します。消費されたコンピューティング時間あたりのクレジット量を知る方法については、 Snowflakeサービス利用表 の「サーバーレス機能クレジットテーブル」をご参照ください。
イベントテーブルでクラスタリングを有効にすると、バックグラウンドプロセス が開始され、完了までに時間がかかります。プロセスが完了すると、ダッシュボードを使用するとパフォーマンスが向上するはずです。
クエリ時間枠を短縮¶
フィルターでより小さい時間枠を選択すると、スキャンされるデータが少なくなり、クエリのパフォーマンスが向上します。コネクタの健全性とパフォーマンスに関する最新の情報と最高のパフォーマンスを得るには、 Last Hour フィルターを使用してください。
制限事項¶
Openflowコネクタダッシュボードは、イベントテーブルに保存されたデータを使用して、Openflowコネクタに関する洞察を提供します。選択した期間とイベントテーブルによっては、ダッシュボードに表示される情報がコネクタの現在のステータスを反映していない場合があります。
詳細な健全性モニタリングは現在、データベース CDC コネクタでのみ利用可能です。
Deployment および Runtime フィルターはOpenflow UI の表示名とは異なる内部名を使用します。これらの名前の一致に関する詳細については、 コネクタのフィルタリング をご参照ください。
既知の問題¶
デプロイ、ランタイム、およびコネクタを前提条件に記載されているバージョンにアップグレードすると、エラーカウントメトリックはアップグレード後に発生したエラーに対してのみ正確になります。