Como usar o Performance Analytics com dados externos

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 12 min. de leitura
  • O Performance Analytics em fontes de dados externas permite que você execute análises detalhadas em dados que não estão em sua instância ServiceNow.

    Quando você coleta pontuações em dados externos, o Performance Analytics 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. Essa 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, um detalhamento e a instrução SQL usada para coletar pontuações para cada elemento de detalhamento desse indicador.

    Formatos de banco de dados compatíveis para dados externos

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

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

    Criar 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. Dê ao indicador um Nomedescritivo.
    3. No campo Frequência, especifique a frequência dos pontos de dados do indicador, como Diário, Semanalou Mensal.
    4. Na guia Origem, selecione uma Fonte de Dados para coletar pontuações.
      Somente fontes de dados do tipo JDBC são compatíveis com o Performance Analytics. Consulte a documentação das fontes de dados para obter informações sobre como configurar fontes de dados.
      Nota:
      A Instrução SQL e a tabela de conjunto de importação definidas na fonte de dados não são usadas pelo Performance Analytics.
    5. Especifique a Instrução SQL a ser usada para calcular o valor de pontuação.
      A instrução SQL deve retornar um valor agregado com o alias valuee deve filtrar dados com base em um campo de data.
      Importante:
      O alias agregado deve ser o valor.
      Para um indicador simples, a instrução SQL será algo como SELECT count(*) AS value FROM... WHERE DATE(date_field) >= DATE(${start_at}).

      Para indicadores mais complexos, talvez você também precise de uma condição de que DATE seja anterior à data que DATEADD retorna. Aqui, um indicador mensal com dados complexos tem a instrução SQL SELECT count(*) AS value FROM... WHERE DATE(date_field) >= DATE(${start_at}) AND 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 no campo Direção.
      Ferramentas de análise e exibições gráficas usam esta Direção com este indicador.
      Dica:
      Defina uma direção sempre que puder. Todos os indicadores-chave devem ser definidos como Maximizar ou Minimizar.
      ValorCaso de uso
      Maximizar Selecione se desejar um aumento na pontuação deste indicador. Por exemplo, considere selecionar Maximizar para um indicador que mostra receita. As ferramentas de análise e os elementos gráficos refletem que um aumento na pontuação deste indicador é bom e uma diminuição é ruim.
      Minimizar Selecione se for desejada uma diminuição na pontuação deste indicador. Por exemplo, considere selecionar Minimizar para um indicador que mostra custos. As ferramentas de análise e os elementos gráficos refletem que uma diminuição na pontuação deste 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 de 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 de FX, selecione Usar 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érie temporal de serem aplicados ao indicador. Para obter mais informações, consulte Excluir série temporal de um indicador.

      Se você selecionar Tempo como a unidade, o tempo será fornecido como Dias, Horas e Minutos. Se a propriedade do sistema glide.ui.duration.seconds.enabled existir e for verdadeira, os segundos também serã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 o Microsoft Excel.

      Precisão O número de dígitos após o separador decimal. Para obter mais informações, consulte Arredondamento e precisão em indicadores.

      Este campo não está disponível quando a unidade é Usar moeda de referência. Nesse caso, a precisão é herdada da moeda de referência.

      Formato do número As abreviaturas 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 na experiência Análise da plataforma.
    8. Na guia Controle de acesso, defina se deseja salvar este indicador na biblioteca e se deve limitar a visibilidade do indicador por usuário, grupo ou função.
      Ativar Compartilhar na biblioteca significa que o indicador estará disponível nos seguintes locais:
      • A lista de KPIs na biblioteca de experiências Análise da plataforma
      • 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: Na guia Outro, defina várias propriedades diversas.
      Tabela 2. Campos da guia "Outros"
      Campo Descrição
      Série de Tempo 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:
      Você não pode 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érie temporal.
      Perfil do grupo em tempo real

      Registro de perfil de grupo em tempo real [live_group_profile] para um grupo de feed de atividades. 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 de atividades.

      Ordem

      Número que indica a ordem na qual 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 campo Ordem, os indicadores serão exibidos de A a Z usando o campo Nome. Para usar o campo de ordem, você deve inserir números de ordem para todos os indicadores. Se você inserir números para apenas alguns indicadores, a ordem em que os indicadores são exibidos será revertida para a até z.

      Não usado na experiência Análise da plataforma.

      Tipo de gráfico padrão

      Defina um tipo de gráfico padrão (linha, coluna, curva ou área) para este indicador. Ao abrir 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 em Hub de análise ou Detalhes de KPI, essa preferência será lembrada.

      Linhas contínuas de renderização

      Quando selecionados, Hub de análise e Detalhes de KPI mostram linhas de dados contínuas para este indicador, mesmo quando não há 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.

      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 selecionados, Hub de análise e Detalhes de KPI podem 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 associado 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 30 dias em widgets. Você pode substituir este padrão em Hub de análise, Detalhes de KPI, widgets de painel ou visualização de dados do espaço.
      • O IT Live Group é notificado sobre mudanças no indicador.
      • O indicador é listado em terceiro lugar na lista Hub de análise 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 em 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.
      • O Hub de análise e Detalhes de KPI o podem mostrar a pontuação deste indicador em tempo real.

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

    10. Opcional: Na guia Previsão, defina o método de previsão, o número de períodos de coleta de dados a serem previstos, 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 do Performance Analytics.
    11. Salve o indicador.
    12. Pressione Testar coleção.
      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.

    Criar um detalhamento usando dados externos

    Crie um detalhamento externo para definir quais elementos estão disponíveis para dividir 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 5.000 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 uma fonte de dados que contenha os registros que você deseja usar como elementos de detalhamento.
      Somente fontes de dados do tipo JDBC são compatíveis com o Performance Analytics. Consulte a documentação das fontes de dados para obter informações sobre como configurar fontes de dados.
      Nota:
      A Instrução SQL e a tabela de conjunto de importação definidas na fonte de dados não são usadas pelo Performance Analytics.
    4. Especifique uma Instrução SQL para selecionar os elementos de detalhamento.
      A Instrução SQL deve retornar a chave exclusiva de cada elemento de detalhamento com o alias id e o nome de exibição do elemento com o alias name, como SELECT guid AS id, user_name AS name FROM....
      Importante:
      O alias da chave exclusiva deve ser id e o alias do nome de exibição deve ser name.
    5. Salve o detalhamento.
    6. Pressione Testar coleção.
      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.

    Configurar um indicador externo para usar um detalhamento externo

    Associe um indicador externo e um detalhamento externo para definir como coletar pontuações de detalhamento 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.
    2. Selecione um indicador.
    3. Na lista relacionada Detalhamentos, clique em Novo.
    4. Selecione o Detalhamento externo a ser aplicado a este indicador.
    5. No campo Instrução SQL, insira uma instrução SQL que calcule o valor de 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 value e 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, SELECT count(*) AS value, guid as id FROM... WHERE DATE(date_field) >= DATE({$start_at}) GROUP BY guid
      Importante:
      O alias agregado deve ser o valor e o alias da chave exclusiva de detalhamento deve ser o id.
    6. Salve as mudanças.
    7. Pressione Testar coleção.
      Esta ação testa a instrução SQL que calcula o valor de 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.

    Testar indicadores externos e detalhamentos

    Teste seus indicadores e detalhamentos externos 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 o detalhamento que você deseja testar.
    3. Clique no botão Testar.
      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 o Performance Analytics com dados externos, você deve filtrar instruções SQL que coletam pontuações por data.

    Nas instruções SQL do indicador e de detalhamento do indicador, filtre a consulta por data, como WHERE DATE(my_date_field) >= DATE(${start_at}). Não é necessário filtrar as 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 essa variável.

    Quando você testa um indicador ou detalhamento, a variável ${start_at} é sempre definida para a data atual.

    Limitações ao usar o Performance Analytics com dados externos

    Certas funcionalidades do Performance Analytics não estão disponíveis quando você mede dados externos.

    • Você não pode coletar snapshots
    • Não é possível exibir pontuações em tempo real
    • Você não pode aplicar detalhamentos de 2º nível
    • Você não pode usar visualizações de widget que dependem de detalhamentos de 2º 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