Catégories :: Fonctions de table (Cortex Agents)

GET_AI_OBSERVABILITY_LOGS (SNOWFLAKE.LOCAL)¶

Récupérez les données de journal pour un événement d’observabilité Cortex Agent, tel qu’un avertissement ou un échec.

Appelez cette fonction pour récupérer des informations sur les événements qui se sont produits lors d’une exécution d’évaluation Cortex Agent. Pour plus d’informations, voir Évaluations Cortex Agent.

Voir aussi :: GET_AI_RECORD_TRACE (SNOWFLAKE.LOCAL), GET_AI_EVALUATION_DATA (SNOWFLAKE.LOCAL), EXECUTE_AI_EVALUATION

Syntaxe¶

SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_LOGS( <database>, <schema>, <agent_name>, <agent_type> )

Arguments¶

database: Nom de la base de données contenant l’agent.
schema: Nom du schéma contenant l’agent.
agent_name: Nom de l’agent pour lequel récupérer un enregistrement.
agent_type: Type d’agent pour lequel récupérer les données d’évaluation. Utilisez la constante de chaîne CORTEX AGENT. La valeur est insensible à la casse.

Renvoie¶

Pour plus de détails sur les informations contenues dans les événements d’observabilité AI, voir Données d’observabilité.

Exigences en matière de contrôle d’accès¶

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :


Privilège	Objet	Remarques
CORTEX_USER	Rôle de la base de données
USAGE	Agent Cortex
MONITOR	Agent Cortex

Pour effectuer une opération sur un objet dans un schéma, il est nécessaire de disposer d’au moins un privilège sur la base de données parente et d’au moins un privilège sur le schéma parent.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Pour connaître les autorisations de contrôle d’accès complètes requises par les évaluations de Cortex Agent, consultez Évaluations Cortex Agent — Exigences en matière de contrôle d’accès.

Exemples¶

L’exemple suivant vérifie les erreurs et les avertissements pour une exécution appelée run-1, où l’agent est nommé evaluated_agent stocké sur le schéma eval_db.eval_schema :

SELECT * FROM TABLE(SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_LOGS(
  'eval_db',
  'eval_schema',
  'evaluated_agent',
  'CORTEX AGENT')
)
  WHERE TRUE
    AND (record:"severity_text"='ERROR' or record:"severity_text"='WARN')
    AND record_attributes:"snow.ai.observability.run.name"='run-1';