Usando Performance Analytics com dados externos

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 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 ServiceNow instâ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 do Performance Analytics 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.

    Formatos de banco de dados compatíveis com dados externos

    Performance Analytics compatível somente com os formatos de banco de dados que ServiceNow suporte por padrão. Se um cliente adicionar um driver JDBC para um formato de banco de dados incompatível, Performance Analytics o não é compatível com esse formato de banco de dados como uma fonte de dados externa.

    Tabela 1. Formatos de banco de dados compatíveis
    SQL Server Type Porta
    MySQL 3306
    Microsoft SQL Server 1433
    Oracle 1521

    Crie um indicador para dados externos

    Crie um indicador externo para definir quais dados avaliar e a instrução SQL usada para determinar a pontuação do indicador.

    Antes de Iniciar

    Função necessária: pa_admin, pa_power_user ou admin

    Procedimento

    1. Navegar até Tudo > Performance Analytics > Indicadores Externos e clique em Novo .
    2. Forneça um indicador descritivo Nome .
    3. Em Frequência especifique a frequência dos pontos de dados do indicador, como Diariamente , Semanalmente , ou Mensal .
    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 Performance Analytics. 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) > DATEADD(month, 1, start_at) .

    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.
      ValorCaso 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 desse 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.
    7. Opcional: Especifique qualquer uma destas propriedades do indicador:
      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.

      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.

      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, os 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 Microsoft Excel.

      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.

      Este campo não está disponível quando a unidade é Use moeda de referência . Nesse 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.
      Chave Identifica o indicador como um indicador-chave. Usado somente para filtrar a lista de indicadores em Performance Analytics > Hub de análise. Não usado em Análise da plataforma experiência.
    8. Em Controle de acesso , defina se este indicador deve ser salvo na biblioteca e se deve ser limitado 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 plataforma biblioteca 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
    9. Opcional: Em Outro defina várias propriedades diversas.
      Tabela 2. Campos da guia "Outros"
      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.

      Para obter mais informações, consulte Aplicar agregações de séries temporais.
      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

      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 ServiceNow AI Platform, consulte Feed em tempo real .

      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, insira 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 plataforma experiê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álise ou Detalhes de KPI para 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álise ou Detalhes de KPI, essa preferência é lembrada.

      Linhas contínuas de renderização

      Quando selecionado, o. Hub de análise e. Detalhes de KPI mostrar 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álise ou Detalhes de KPI.

      Mostrar pontuação em tempo real

      Quando selecionado, o. Hub de análise e. Detalhes de KPI pode 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.

      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.

      Por exemplo, na guia Outro, você pode configurar um indicador da seguinte forma:
      • Por padrão, ele mostra uma soma de pontuações de execução de 30 dias nos 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álise lista 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álise e. Detalhes de KPI.
      • As linhas de dados do indicador são mostradas ininterruptas, mesmo quando os dados estão ausentes.
      • . Hub de análise e. Detalhes de KPI pode mostrar a pontuação deste indicador em tempo real.

      A outra guia em um indicador com configurações listadas anteriormente

    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 Performance Analytics.
    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 do indicador, defina um detalhamento externo e associe-o ao indicador.

    Crie um detalhamento usando dados externos

    Crie um detalhamento externo para definir quais elementos estão disponíveis para detalhar as pontuações do indicador externo.

    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 externo são armazenados nas tabelas pa_ext_elements.

    Procedimento

    1. Navegar até Tudo > Performance Analytics > Detalhamentos Externos.
    2. Clique em Nova.
    3. Selecione um Fonte de dados que contém os registros que você deseja usar como elementos de detalhamento.
      Somente fontes de dados do tipo JDBC são compatíveis com a Performance Analytics. 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.
    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 .
    5. Salve o detalhamento.
    6. Pressione Coleção de testes .
      Esta ação testa a consulta que seleciona os elementos de detalhamento.

    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

    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é Tudo > Performance Analytics > Indicadores 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 para 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 depois de adicionar cada uma.

    Indicadores externos e detalhamentos de teste

    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é Tudo > Performance Analytics > Indicadores Externos ou Performance Analytics > Detalhamentos 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

    Ao usar Performance Analytics 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 Performance Analytics com dados externos

    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