Monitoramento do administrador Cortex Analyst

Para melhorar a qualidade das respostas fornecidas pelo Cortex Analyst, você deve continuar refinando o modelo ou a exibição semântica. Para ajudá-lo a refinar o modelo ou a exibição, o Cortex Analyst registra as solicitações em uma tabela de eventos no banco de dados Snowflake.

Os registros incluem o seguinte:

  • O usuário que fez a pergunta

  • A pergunta feita

  • SQL gerado

  • Erros e/ou avisos

  • Corpos de solicitação e resposta

  • Outros metadados

Há um pequeno atraso, na ordem de 1 a 2 minutos, entre o momento da solicitação até ela aparecer na exibição.

Acesso aos logs

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)

  • Privilégio WRITE na área de preparação (para modelos semânticos armazenados em um arquivo na área de preparação)

Como alternativa, é possível consultar os logs diretamente do banco de dados Snowflake usando SQL, dependendo de seus privilégios.

Consulta de logs com SQL

Chame a função de tabela SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS para recuperar os registros de uma exibição ou um modelo semântico específico. Essa função de tabela realiza verificações de controle de acesso para garantir que o chamador tenha os privilégios necessários para acessar os dados da solicitação.

A seguir, um exemplo de como chamar a função:

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

Ao chamar essa função, passe os seguintes argumentos:

  • semantic_model_or_view_type: especifica o tipo de modelo semântico ou exibição usado nas solicitações:

    • Para um modelo semântico definido em um arquivo em um estágio, especifique 'FILE_ON_STAGE'.

    • Para uma exibição semântica, especifique 'SEMANTIC_VIEW'.

  • semantic_model_or_view_name: especifica o local onde o modelo semântico ou a exibição é definida:

    • 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).

    • Para uma exibição semântica, especifique o nome totalmente qualificado da exibição semântica.

Retorna: uma tabela com todas as solicitações de API para o modelo semântico ou a exibição especificada.

Se uma consulta foi feita usando YAML em linha (em vez de exibição semântica ou arquivo na área de preparação), a solicitação pode ser acessada por meio da função de tabela, mas fica visível na exibição e na tabela de eventos detalhadas abaixo.

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.