--- title: "Cato Ler Apenas API - appStats" slug: "cato-read-only-api-appstats" updated: 2026-07-30T01:47:56Z published: 2026-07-30T01:47:56Z canonical: "knowledge.catonetworks.com/cato-read-only-api-appstats" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Cato Ler Apenas API - appStats ## Visão geral do appStats A API appStats é baseada na tela Analytics da Aplicação e fornece dados agregados de rede ao longo de um intervalo de tempo por fonte, destino, aplicativo, e assim por diante. Cada consulta calcula a agregação sobre diferentes medidas (bytes enviados, bytes recebidos, número de fluxos, etc...) dada uma certa função de agregação (soma, máximo, média, etc...) e diferentes dimensões (nome_do_site, usuário, aplicativo, etc...) Exemplos de uso da consulta appStats: - Calcular total/média/máximo de largura de banda de um site específico - Máximo número de fluxos gerados para um destino específico - Os 10 aplicativos mais usados por um determinado host ## Argumentos para appStats Estes são os argumentos que você pode passar e definir os dados que são retornados pela consulta (todos os campos são obrigatórios): - IDs de contas - medidas - filtros - dimensão - ordenar - intervalo de tempo ### Argumento appStats ID da Conta Insira um ou mais IDs de contas para os dados que a consulta retorna. Este ID da Conta não é mostrado no Aplicativo de Gerenciamento Cato, em vez disso, é o número na URL para o Aplicativo de Gerenciamento Cato. Por exemplo, o ID da Conta é 26 para a seguinte URL: https://cc.catonetworks.com/#!/26/topologia. ### Argumento appStats filtros O argumento `filtros` permite definir os dados específicos que são incluídos na consulta. Estes são os argumentos que você pode definir: - fieldName - define o Tipo de campo que você deseja Filtrar (para mais informações, consulte abaixo [Campos appStats](/v1/docs/cato-read-only-api-appstats#appstats-fields)) - operator - define como Ativar os Valores para Filtrar os Dados (para mais informações, consulte abaixo [Operador de Filtro appStats](/v1/docs/cato-read-only-api-appstats#appstats-filteroperator)) - valores - define o valor do filtro que é usado com o operador A seguinte sintaxe de `filtros` é um exemplo de uma consulta que é filtrada para mostrar dados para uma aplicação específica: ```plaintext "filters": [    {        "fieldName": "aplicação",        "operator": "é",        "values": [            "Slack"        ]    } ] ``` ### Argumento appStats dimensões Use o argumento `dimensões` para agrupar campos com os mesmos valores em linhas resumidas. O exemplo a seguir agrupa os campos de acordo com os nomes dos sites: ```plaintext "dimensions": [    {        "fieldName": "site_name"    } ] ``` ### Argumento appStats medidas O argumento `medidas` permite definir os campos que você deseja que a consulta retorne e seu tipo de agregação. Estes são os argumentos que você pode definir: - fieldName - define o Tipo de campo que você deseja Filtrar (para mais informações, consulte abaixo [Campos appStats](/v1/docs/cato-read-only-api-appstats#appstats-fields)) - aggType - define o Tipo de agregação (para mais informações, consulte abaixo [Agregação appStats](/v1/docs/cato-read-only-api-appstats#appstats-aggregation)) O exemplo a seguir mostra a sintaxe de `medidas` para uma consulta que mede o resumo dos fluxos criados para o aplicativo Slack: ```plaintext "filters": [    {        "fieldName": "aplicação",        "operator": "é",        "values": [            "Slack"        ]    } ] "measures": [    {        "fieldName": "flows_created",        "aggType": "sum"    } ] ``` ### Argumento appStats classificação O argumento `classificação` define como os dados são classificados. O exemplo a seguir mostra a sintaxe de `classificação` para uma consulta que mede o resumo dos fluxos criados para o aplicativo Slack. Em seguida, classifica os dados em ordem decrescente de fluxos criados: ```plaintext "filters": [    {        "fieldName": "aplicação",        "operator": "é",        "values": [            "Slack"        ]    } ] "measures": [    {        "fieldName": "flows_created",        "aggType": "sum"    } ] "sort": [    {        "fieldName": "flows_created",        "order": "desc"    } ] ``` ### Argumento appStarts intervalo de tempo Define o `período de tempo` da consulta. ```plaintext "intervalo de tempo": "últimos.P2D" ``` ## Consulta de exemplo appStats Este é um exemplo de uso da consulta API appStats para retornar a soma de fluxos criados para o aplicativo Slack para cada site ao longo do período de tempo dos últimos dois dias. Os dados são classificados em ordem decrescente para os cinco principais sites. **Exemplo de consulta** ```plaintext consulta appStats($accountID: ID!, $medidas: [Medida], $dimensões: [Dimensão], $filtros: [AppStatsFiltro!], $classificação: [AppStatsClassificação!], $intervalo de tempo: Intervalo de Tempo!, $limite: Int, $de: Int) {  appStats(    accountID: $accountID    timeFrame: $intervalo de tempo    medidas: $medidas    dimensões: $dimensões    filtros: $filtros    classificação: $classificação  ) {    id    records(limite: $limite, de: $de) {      fieldsUnitTypes      fieldsMap      trends    }  } } ``` **Valores das Variáveis** ```plaintext {  "accountID": "1234",  "dimensões": [    {      "fieldName": "site_name"    }  ],  "medidas": [    {      "fieldName": "flows_created",      "aggType": "sum"    }  ], "filters": [    {        "fieldName": "aplicação",        "operator": "é",        "values": [            "Slack"        ]    } ]  "classificação": [    {      "fieldName": "flows_created",      "order": "desc"    }  ],  "intervalo de tempo": "últimos.P2D",  "limite": 5,  "de": 0 } ``` **Saída de Exemplo AppStats** ```plaintext {  "dados": {    "appStats": {      "id": "1234",      "registros": [        {          "fieldsMap": {            "flows_created": "116660",            "site_name": "Sample Socket"          }        },        {          "fieldsMap": {            "flows_created": "105655",            "site_name": "Sample Socket 2"          }        }      ]    }  } } ``` ## Campos appStats Esta é uma descrição dos campos nas consultas de appStats. | Item | Description | | --- | --- | | aplicação | nome da aplicação na nuvem | | nova_aplicação | novo identificador de aplicação na nuvem | | aplicação_descoberta | número total de aplicativos utilizados | | tráfego | a soma total dos dados enviados e recebidos em bytes | | ascendente | dados enviados para aplicativos na nuvem | | descendente | dados baixados de aplicativos na nuvem | | score_de_risco | a pontuação de risco da aplicação atribuída pelo Cato | | nível_de_risco | o nível de risco da aplicação | | autorizado | aplicativos na nuvem aprovados para uso e gerenciados pela organização | | localização_da_sede | o país onde a sede registrada da aplicação está localizada | | é_aplicação_na_nuvem | indica se a aplicação é considerada um aplicativo na nuvem/app SaaS | | categoria | a categoria de aplicação na nuvem | | descrição | descrição da categoria | | ip | IP do host ou Cliente SDP | | subnet | nome da subnet | | domínio | SNI SSL, nome do host HTTP, nome DNS ou IP do destino | | dest_ip | endereço IP do servidor (apenas relevante para conexões WAN) | | id_do_site_de_origem | ID interna única do Cato para o site | | src_site_name | site de origem ou usuário SDP | | país_do_site | país onde o site está localizado | | estado_do_site | estado onde o site está localizado | | id_do_usuário_vpn | ID interna única do Cato para o usuário SDP | | fluxos_criados | Número de conexões criadas | | site_de_destino | site de destino ou ID do usuário SDP (proto) | | destino_é_site_ou_vpn | site de destino ou usuário SDP | | id_do_site_de_destino | site de destino ou ID do usuário SDP (DB) | | dest_site_name | site de destino ou nome de usuário SDP | | direção_tráfego | direção do tráfego | | device_name | Nome do PC ou dispositivo | | nome_do_anúncio | Nome do Diretório Ativo | | src_ip | IP para host ou Cliente SDP | | interface_de_socket | Nome para interface de Socket | | fonte_é_site_ou_vpn | O tráfego é site ou Cliente SDP | ## agregação de appStats Estes são os Valores para o appStats `aggType`: - soma - contagem - contagem_distinta - distinto - média - max - min - qualquer ## appStats filterOperator Estes são os valores para o appStats filterOperator: - é - não_é - em - não_em - existe - não_existe - entre - não_entre - maior_que - maior ou igual - menor_que - menor ou igual