Cortex Analyst 管理者モニタリング¶

Cortex Analyst によって提供される回答の質を向上させるには、セマンティックモデルや表示を改良し続ける必要があります。モデルや表示を改良するために、 Cortex Analyst は、リクエストをSnowflakeデータベースのイベントテーブルにログします。

ログには以下が含まれます。

質問したユーザー
質問
生成された SQL
エラーおよび/または警告
リクエスト本文と応答本文
その他のメタデータ

リクエストが行われてからビューに表示されるまでには、1～2分単位の小さなタイムラグがあります。

ログへのアクセス¶

You can view these logs in the Monitoring tab of the Semantic View within Snowsight. In order to view the logs, users must have the SELECT privilege on referenced tables, in addition to:

MONITOR or OWNERSHIP on the semantic view (when using semantic views)
ステージに対する WRITE 権限（ステージ上のファイルに格納されたセマンティックモデルの場合）

また、権限によっては、 SQL を使用してSnowflakeデータベースから直接ログをクエリすることもできます。

SQL によるログのクエリ¶

SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS テーブル関数を呼び出し、特定のセマンティックモデルやビューのログを取得します。このテーブル関数は、呼び出し元がリクエストデータにアクセスするために必要な権限を持っていることを保証するために、アクセス制御チェックを実行します。

以下は関数の呼び出し方の例です。

SELECT * FROM TABLE(
  SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS(
    '<semantic_model_or_view_type>',
    '<semantic_model_or_view_name>'
  )
);

Copy

この関数を呼び出す際には、以下の引数を渡します。

semantic_model_or_view_type: リクエストで使用されるセマンティックモデルまたはビューのタイプを指定します。
- ステージ上のファイルで定義されたセマンティックモデルには、 'FILE_ON_STAGE' を指定します。
- セマンティック表示の場合は、 'SEMANTIC_VIEW' を指定します。
semantic_model_or_view_name: セマンティックモデルまたはビューが定義されている場所を指定します。
- For a semantic view defined in a file on a stage, specify the fully qualified path to the semantic view specification file (for example, @my_db.my_schema.my_stage/path/to/file.yaml).
- セマンティック・ビューの場合は、セマンティック・ビューの完全修飾名を指定します。

戻り値指定されたセマンティックモデルまたはビューに対する API リクエストをすべて含むテーブル。

インライン YAML（セマンティックビューまたはステージ上のファイルの代わりに）を使用してクエリが行われた場合、リクエストにはテーブル関数からはアクセスできませんが、以下で詳細を説明するビューとイベントテーブルに表示されます。

If you are using a role that has been granted the SNOWFLAKE.CORTEX_ANALYST_REQUESTS_ADMIN or SNOWFLAKE.CORTEX_ANALYST_REQUESTS_VIEWER application role, you can query the SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V view. This view includes all requests to Cortex Analyst across all semantic models and views.

You can also query the raw event data in the SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_RAW event table. The responses are in the OpenTelemetry format. The SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V view contains the same data, formatted and processed for human readability.