--- sourceDocument: Yokohama Platform Analytics sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/now-intelligence Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Yokohama Platform Analytics ft:clusterId : - par bundleId : - par workflow : - Platform --- # Usando a Análise de desempenho com dados externos # Usando a Análise de desempenho com dados externos {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 12 min. de leitura A Análise de desempenho em fontes de dados externas permite que você execute análises detalhadas em dados que não estão em seu ServiceNowinstância. Quando você coleta pontuações em dados externos, a Análise de desempenho armazena pontuações e elementos de detalhamento dos dados externos em sua instância. Os dados brutos que estão sendo analisados permanecem na fonte de dados externa e não são copiados para sua instância. Esta funcionalidade permite analisar e compartilhar métricas sem duplicar os dados subjacentes. A coleta de dados externos da Análise de desempenho usa três tipos de registros de configuração: * Um indicador externo que especifica a fonte de dados JDBC e a instrução SQL usada para coletar pontuações. * Um detalhamento externo que especifica a fonte de dados JDBC e a instrução SQL usada para especificar elementos de detalhamento. * Um detalhamento de indicador externo que define o relacionamento entre um indicador externo e o detalhamento e a instrução SQL usada para coletar pontuações de cada elemento de detalhamento desse indicador. {#pa-external-data__ul_dzz_dyt_2bb} ## Formatos de banco de dados compatíveis com dados externos {#ariaid-title2} Performance Analyticssuporta somente os formatos de banco de dados que ServiceNowsuporte por padrão. Se um cliente adicionar um driver JDBC para um formato de banco de dados incompatível, Performance Analyticso não é compatível com esse formato de banco de dados como uma fonte de dados externa. {#supported-database-formats__table_ov4_ctn_lgb__entry__2} | Tipo de SQL Server | Porta | |-|-| | MySQL | 3306 | | Microsoft SQL Server | 1433 | | Oracle | 1521 | [Tabela 1. Formatos de banco de dados compatíveis] {#supported-database-formats__table_ov4_ctn_lgb} **Tópicos relacionados** * [Fonte de dados do tipo JDBC](https://www.servicenow.com/docs/access?context=r_JDBCTypeDataSource&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US) ## Crie um indicador para dados externos {#ariaid-title3} Crie um indicador externo para definir quais dados avaliar e a instrução SQL usada para determinar a pontuação do indicador.{#create-ind-ext-data__ph_create-external-indicator} ### Antes de Iniciar Função necessária: pa_admin, pa_power_user ou admin ### Procedimento 1. Navegar até TudoPerformance AnalyticsIndicadores Externos e clique em Novo . 2. Dê um descritivo ao indicador Nome . 3. Em Frequência especifique a frequência dos pontos de dados do indicador, como Diariamente , Semanalmente , ou Mensal . {#create-ind-ext-data__step_ext-indicator-freq} {#create-ind-ext-data__step_ext-indicator-freq} 4. Em Origem selecione uma Fonte de dados para coletar pontuações de. Somente fontes de dados do tipo JDBC são compatíveis com a Análise de desempenho. Consulte a documentação de fontes de dados para obter informações sobre como configurar fontes de dados. Nota: A declaração SQL e a tabela Conjunto de importação definidas na fonte de dados não são usadas pela Análise de desempenho. 5. Especifique o. Declaração SQL para usar para calcular o valor da pontuação. A instrução SQL deve retornar um valor agregado com o alias valuee devem filtrar dados com base em um campo de data. Importante: O alias agregado deve ser valor . Para um indicador simples, a instrução SQL será algo como `SELECIONE count(*) COMO valor de... EM QUE DATE(date_field) > `. Para indicadores mais complexos, você também pode precisar de uma condição de que A DATA seja anterior à data retornada POR DATEADD. Aqui, um indicador mensal com dados complexos tem a instrução SQL `SELECIONE count(*) COMO valor de... EM QUE DATE(date_field) E DATE(date_field 1) `. {#create-ind-ext-data__step_ext-indicator-sql} {#create-ind-ext-data__step_ext-indicator-sql} 6. Se você preferir que a pontuação deste indicador aumente ou diminua ao longo do tempo, selecione Maximizar ou Minimizar em Direção campo. As ferramentas analíticas e exibições gráficas usam isso Direção com este indicador. Dica: Sempre que puder, defina uma direção. Todos os indicadores-chave devem ser definidos para maximizar ou minimizar. | Valor | Caso de uso | | Maximizar | Selecione se um aumento nesta pontuação do indicador for desejado. Por exemplo, considere selecionar Maximizar para um indicador que mostra receita. As ferramentas analíticas e elementos gráficos refletem que um aumento na pontuação do indicador é bom e uma diminuição é ruim. | | Minimizar | Selecione se uma diminuição nesta pontuação do indicador for desejada. Por exemplo, considere selecionar Minimizar para um indicador que mostra custos. As ferramentas analíticas e elementos gráficos refletem que uma diminuição na pontuação desse indicador é boa e um aumento é ruim. | | Nenhum(a) | Selecione se a direção da mudança nesta pontuação não for importante para o seu negócio. | |-|-| {#create-ind-ext-data__choicetable_myb_r3v_vcb} 7. **Opcional:** Especifique qualquer uma destas propriedades do indicador: {#create-ind-ext-data__table_uh3_vsv_q2b__entry__2}{#create-ind-ext-data__row_unit}{#create-ind-ext-data__row_precision} | Campo | Descrição | |-|-| | Unidade | A unidade de medida da pontuação, como número, dias ou porcentagens. Para coletar pontuações na moeda de referência do sistema em um campo Preço, Moeda ou Moeda FX, selecione Use moeda de referência . Para obter mais informações, consulte [Pontuações do indicador na moeda de referência](https://servicenow-prod.fluidtopics.net/Nmydv1kgjo7XYuAekgJKnw "Você pode acompanhar as tendências dos campos monetários dos tipos Preço, Moeda ou Moeda FX. As pontuações de um indicador com base em qualquer um desses campos são coletadas nos valores da moeda de referência."). Se você selecionar % ou um período de tempo como a unidade, considere excluir alguns tipos de séries temporais de serem aplicados ao indicador. Para obter mais informações, consulte [Exclua séries temporais de um indicador](https://servicenow-prod.fluidtopics.net/KLl_ldxkG6JXBsqCqAzZTA "Algumas agregações de séries temporais são inadequadas para serem aplicadas a alguns indicadores. Você pode excluir séries temporais em indicadores automatizados, de fórmula e manuais. As séries temporais excluídas não podem ser selecionadas no Hub de análise, Detalhes de KPIou widgets. Outras séries temporais permanecem selecionáveis."). Se você selecionar Hora como a unidade, o tempo será fornecido como Dias, Horas e Minutos. Se a propriedade do sistema glide.ui.duration.seconds.enabledexiste e é verdadeiro, segundos também são exibidos. Nesse caso, os segundos também são exibidos para todos os campos de tempo na instância e são incluídos nas exportações para MicrosoftExcel. | | Precisão | O número de dígitos atrás do separador decimal. Para obter mais informações, consulte [Arredondamento e precisão em indicadores](https://servicenow-prod.fluidtopics.net/L4gOmWpkfnijtJDlHiDSKg "Os indicadores arredondam resultados fracionais usando \"Arredondamento do banqueiro\" ou arredondamento matemático, dependendo do indicador Precisão ."). Este campo não está disponível quando a unidade é Use moeda de referência . Neste caso, a precisão é herdada da moeda de referência. | | Formato do número | As abreviações usadas para números grandes, de milhares a quintilhões. Para obter mais informações, consulte [Arredondamento e precisão em indicadores](https://servicenow-prod.fluidtopics.net/L4gOmWpkfnijtJDlHiDSKg "Os indicadores arredondam resultados fracionais usando \"Arredondamento do banqueiro\" ou arredondamento matemático, dependendo do indicador Precisão ."). | | Chave | Identifica o indicador como um indicador-chave. Usado somente para filtrar a lista de indicadores em Performance AnalyticsHub de análise. Não usado em Análise da plataformaexperiência. | [ ] {#create-ind-ext-data__table_uh3_vsv_q2b} 8. Em Controle de acesso , defina se este indicador deve ser salvo na biblioteca e se deve limitar a visibilidade do indicador por usuário, grupo ou função. Ativando Compartilhar na biblioteca significa que o indicador estará disponível nos seguintes locais: * A lista de KPIs no Análise da plataformabiblioteca de experiências * Detalhes de KPI * Hub de análise, mas somente em instâncias atualizadas que não migraram totalmente para Análise da plataforma {#create-ind-ext-data__ul_hd3_lrn_1bc} {#create-ind-ext-data__cmd_access-control-fields} 9. **Opcional:** Em Outro defina várias propriedades diversas. {#create-ind-ext-data__table_hft_ltv_q2b__entry__2}{#create-ind-ext-data__row_default-time-series}{#create-ind-ext-data__row_live-group-profile}{#create-ind-ext-data__row_order}{#create-ind-ext-data__row_render-cont-lines} | Campo | Descrição | |-|-| | Série temporal padrão | Uma função analítica predefinida, como uma média de execução de 7 dias, a ser aplicada ao indicador em vez de mostrar as pontuações brutas do indicador.{#create-ind-ext-data__ph_time-series-desc} Para obter mais informações, consulte [Aplicando agregações de séries temporais](https://servicenow-prod.fluidtopics.net/yzV3OahzSfZz9ZamBRiRYg#applying-time-series-aggregations "Você pode agregar mudanças nos indicadores em intervalos de tempo discretos. Essas agregações podem tornar as tendências mais facilmente visíveis ou ajudar a rastrear o andamento em relação a uma meta."). Nota: Não é possível definir a série temporal padrão para um indicador que usa um calendário comercial ou fiscal. Esses calendários não são compatíveis com agregações de séries temporais. | | Perfil do grupo em tempo real | Registro de perfil de grupo em tempo real \[live_group_profile\] para um grupo de feed em tempo real. Especifique um perfil de grupo para fazer com que esse grupo receba notificações sobre este indicador. Para obter mais informações sobre esta aplicação social no Now Platform, consulte [Feed em tempo real](https://www.servicenow.com/docs/access?context=c_GetStartedWithLiveFeed&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). | | Ordem | Número que indica a ordem em que os indicadores são exibidos no Hub de análise. Os indicadores com o valor mais baixo são exibidos na parte superior da lista. Se nenhum valor for fornecido no Pedido os indicadores são exibidos de a a z usando o. Nome campo. Para usar o campo Pedido, você deve inserir os números de pedido para todos os indicadores. Se você inserir números para apenas alguns indicadores, a ordem em que os indicadores são exibidos reverte para A a z. Não usado em Análise da plataformaexperiência. | | Tipo de gráfico padrão | Defina um tipo de gráfico padrão (linha, coluna, spline ou área) para este indicador. Ao abrir o. Hub de análiseou Detalhes de KPIpara este indicador pela primeira vez, o tipo de gráfico padrão é usado. Se o tipo de gráfico for alterado no Hub de análiseou Detalhes de KPI, essa preferência é lembrada. | | Linhas contínuas de renderização | Quando selecionado, o. Hub de análisee. Detalhes de KPImostrar linhas de dados ininterruptas para este indicador, mesmo quando não houver dados para uma data específica. Esse comportamento pode ser útil ao exibir conjuntos de dados com datas de início variadas ou para dados que não são atualizados regularmente, como informações de estoque. As linhas contínuas não são renderizadas quando uma série temporal é definida no indicador ou no Hub de análiseou Detalhes de KPI. | | Mostrar pontuação em tempo real | Quando selecionado, o. Hub de análisee. Detalhes de KPIpode mostrar a pontuação deste indicador em tempo real, bem como o estado atual dos registros associados. Desmarque esta caixa de seleção quando os dados do indicador não estiverem disponíveis em tempo real, como em uma integração que usa dados de uma fonte de terceiros. Para obter mais informações, consulte [Pontuações em tempo real](https://servicenow-prod.fluidtopics.net/QSnui6CKK25I1FQ0WNfTTA "Você pode exibir alguns Performance Analyticspontuações em tempo real em vez de do trabalho de coleta de dados mais recente. Se as pontuações em tempo real estiverem habilitadas, você poderá exibi-las em Detalhes de KPIe em algumas visualizações de dados."). Observação: Uma condição deve ser definida no indicador ou na origem do indicador associada para que as pontuações em tempo real sejam exibidas. | [Tabela 2. Campos da guia "Outros"] {#create-ind-ext-data__table_hft_ltv_q2b} Por exemplo, na guia Outro, você pode configurar um indicador da seguinte forma: * Por padrão, ele mostra uma soma de pontuações de 30 dias em widgets. Você pode substituir este padrão no Hub de análise, Detalhes de KPI, widgets do painel ou visualização de dados do espaço. * O grupo de TI em tempo real é notificado sobre mudanças no indicador. * O indicador está listado em terceiro lugar em Hub de análiselista de indicadores. Todos os outros indicadores também têm sua posição especificada. Esta configuração não afeta a ordem dos indicadores em Detalhes de KPI. * O tipo de gráfico padrão é Spline no Hub de análisee. Detalhes de KPI. * As linhas de dados do indicador são mostradas ininterruptas, mesmo quando os dados estão ausentes. * . Hub de análisee. Detalhes de KPIpode mostrar a pontuação deste indicador em tempo real. {#create-ind-ext-data__ul_x5k_rzc_lwb} 10. **Opcional:** Em Previsão , defina o método de previsão, o número de períodos de coleta de dados para prever, a quantidade de dados históricos nos quais basear a previsão e os limites superior e inferior dos valores de previsão. Para obter mais informações, consulte [Previsões de pontuações da Análise de desempenho](https://servicenow-prod.fluidtopics.net/ofyb~mjQjgOl4q4jZbSkbA#c_ForecastingData "Performance Analytics permite prever pontuações futuras com base no comportamento passado. Você pode prever pontuações em widgets de séries temporais, visualizações de dados de séries temporais, Detalhes de KPIe o. Hub de análise. As pontuações de previsão aparecem como uma linha pontilhada."). {#create-ind-ext-data__cmd_forecasting-fields} 11. Salve o indicador. 12. Pressione Coleção de testes . Esta ação testa a consulta principal do indicador. ### O que Fazer Depois Se você quiser coletar pontuações de detalhamento para o indicador, defina um detalhamento externo e associe-o ao indicador. ## Crie um detalhamento usando dados externos {#ariaid-title4} Crie um detalhamento externo para definir quais elementos estão disponíveis para detalhar as pontuações do indicador externo.{#create-bd-ext-data__ph_ext-bkdwn-short-desc} ### Antes de Iniciar Função necessária: pa_admin, pa_power_user ou admin ### Por Que e Quando Desempenhar Esta Tarefa Por padrão, um detalhamento externo pode conter no máximo 5000 elementos. Este limite é controlado pela propriedade com.snc.pa.dc.max_external_elements. Os elementos de detalhamento externos são armazenados nas tabelas pa_ext_elements. ### Procedimento 1. Navegar até TudoPerformance AnalyticsDetalhamentos Externos. 2. Clique em Novo. 3. Selecione um Fonte de dados que contém os registros que você deseja usar como [elementos de detalhamento](https://servicenow-prod.fluidtopics.net/lBJZJ3coAoV518cNGKBaew#gloss-breakdown-element "Os valores de um detalhamento. Por exemplo, o detalhamento de prioridade pode ter os elementos Crítico, Alto e Baixo."). Somente fontes de dados do tipo JDBC são compatíveis com a Análise de desempenho. Consulte a documentação de fontes de dados para obter informações sobre como configurar fontes de dados. Nota: A declaração SQL e a tabela Conjunto de importação definidas na fonte de dados não são usadas pela Análise de desempenho. {#create-bd-ext-data__step_ext-bkdwn-data-source} {#create-bd-ext-data__step_ext-bkdwn-data-source} 4. Especifique um Declaração SQL para selecionar os elementos de detalhamento. A instrução SQL deve retornar a chave exclusiva para cada elemento de detalhamento com o alias ide o nome de exibição do elemento com o alias name, como `SELECIONE guid COMO ID, user_name COMO nome de... `. Importante: O alias de chave exclusivo deve ser id e o alias do nome de exibição deve ser nome . {#create-bd-ext-data__step_ext-bkdwn-sql} {#create-bd-ext-data__step_ext-bkdwn-sql} 5. Salve o detalhamento. 6. Pressione Coleção de testes . Esta ação testa a consulta que seleciona os elementos de detalhamento. {#create-bd-ext-data__steps_opj_t3b_t1b} ### O que Fazer Depois Depois de definir como coletar elementos de detalhamento, associe o detalhamento externo a um ou mais indicadores externos. ## Configure um indicador externo para usar um detalhamento externo {#ariaid-title5} Associe um indicador externo e detalhamento externo para definir como coletar pontuações de detalhamento para o indicador. ### Antes de Iniciar Função necessária: pa_admin, pa_power_user ou admin ### Procedimento 1. Navegar até TudoPerformance AnalyticsIndicadores Externos. 2. Selecione um indicador. 3. Em Detalhamentos lista relacionada, clique em Novo . 4. Selecione o externo Detalhamento para aplicar a este indicador. 5. Em Declaração SQL Insira uma instrução SQL que calcula o valor da pontuação de cada elemento de detalhamento. A instrução SQL deve usar a mesma função agregada que a instrução SQL do indicador, como COUNT. A instrução SQL deve retornar o valor agregado com o alias valuee a chave exclusiva do elemento de detalhamento com o alias id . A instrução SQL também deve agrupar os dados pela coluna que contém os valores do elemento de detalhamento. Por exemplo, `SELECIONE count(*) COMO valor, guid como ID DE... EM QUE DATE(date_field) É AGRUPADO POR guid` Importante: O alias agregado deve ser valor e o alias de chave exclusiva de detalhamento deve ser id . 6. Salve as mudanças. 7. Pressione Coleção de testes . Esta ação testa a instrução SQL que calcula o valor da pontuação do elemento de detalhamento. ### O que Fazer Depois Repita as etapas anteriores para adicionar detalhamentos adicionais ao indicador. Teste a instrução SQL após adicionar cada uma. ## Testes de indicadores externos e detalhamentos {#ariaid-title6} Teste seus indicadores externos e detalhamentos para garantir que você possa se conectar à fonte de dados externa e coletar os dados esperados. ### Antes de Iniciar Função necessária: pa_admin, pa_power_user ou admin ### Por Que e Quando Desempenhar Esta Tarefa Teste um indicador para testar a consulta desse indicador e as consultas de todos os elementos de detalhamento. Teste um detalhamento para testar a consulta usada para determinar os elementos de detalhamento disponíveis. Nenhuma pontuação ou elemento de detalhamento é salvo quando você testa um indicador ou detalhamento. ### Procedimento 1. Navegar até TudoPerformance AnalyticsIndicadores Externos ou Performance AnalyticsDetalhamentos Externos. 2. Selecione o indicador ou detalhamento que você deseja testar. 3. Clique em Teste botão. Se a consulta for executada com sucesso, o número de pontuações ou elementos de detalhamento que seriam coletados será exibido. Se ocorrer um erro durante o teste, a mensagem de erro será exibida. ### O que Fazer Depois Depois de confirmar que todas as consultas são executadas com sucesso e retornam os dados esperados, adicione o indicador externo a um trabalho de coleta de dados para começar a coletar pontuações. ## Filtrando dados externos por data {#ariaid-title7} Ao usar a Análise de desempenho com dados externos, você deve filtrar instruções SQL que coletam pontuações por data. Nas instruções SQL de detalhamento do indicador e do indicador, filtre a consulta por data, como `EM QUE DATE(my_date_field) > `. Não é necessário filtrar instruções SQL de detalhamento por data, pois as instruções SQL de detalhamento coletam somente elementos e não pontuações. A variável "start_at" contém a data do período que está sendo coletado no formato AAAAMMDD. Para indicadores diários, este valor é sempre a data que está sendo coletada. Para indicadores com frequências de coleta mais longas, como semanal ou mensal, a data é o primeiro dia do período de coleta. A data em que o trabalho de coleta de dados é executado não afeta esta variável. Quando você testa um indicador ou detalhamento, a variável "start_at" é sempre definida como a data atual. ## Limitações ao usar a Análise de desempenho com dados externos {#ariaid-title8} Determinadas funcionalidades da Análise de desempenho não estão disponíveis quando você mede dados externos. * Não é possível coletar snapshots * Não é possível exibir pontuações em tempo real * Você não pode aplicar detalhamentos de segundo nível * Não é possível usar visualizações de widget que dependem de detalhamentos de segundo nível com dados externos. Isso inclui visualizações dinâmicas e de mapa térmico. * Como os snapshots não estão disponíveis, você não pode exibir mudanças nos registros coletados {#pa-ext-data-limitations__ul_gh2_gbb_t1b}