Uso do Performance Analytics com dados externos

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 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 na 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. 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 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 oferece suporte somente aos formatos de banco de dados compatíveis com ServiceNow por padrão. Se um cliente adicionar um driver JDBC para um formato de banco de dados sem suporte, Performance Analytics não oferecerá suporte a 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 serão avaliados 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é Todos > 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 Diariamente, Semanalmenteou Mensalmente.
    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 os 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, você também pode precisar de uma condição em 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 principais indicadores devem ser definidos como Maximizar ou Minimizar.
      ValorCaso de uso
      Maximizar Selecione se for desejado um aumento na pontuação deste indicador. Por exemplo, considere selecionar Maximizar para um indicador que mostra a 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 esta opção se uma diminuição na pontuação deste indicador for desejada. 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 esta opção 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 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éries temporais de serem aplicados ao indicador. Para obter mais informações, consulte Excluir séries temporais de um indicador.

      Se você selecionar Hora como a unidade, a hora será fornecida 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 hora na instância e são incluídos nas exportações para o 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 nos 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 abreviações usadas para números grandes, de milhares a quintilhões. Para obter mais informações, consulte Arredondamento e precisão nos indicadores.
      Chave Identifica o indicador como um indicador-chave. Usado somente para filtrar a lista de indicadores em Performance Analytics > Hub de análise.
    8. Na guia Controle de acesso, defina se deseja publicar este indicador no Hub de análise e na lista de KPIs na experiência Platform Analytics e se deseja limitar a visibilidade do indicador por usuário, grupo ou função.
    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 de análise 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 de tempo 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 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 este aplicativo social no Now Platform, consulte Live Feed.

      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 na qual os indicadores são exibidos será revertida para A a Z.

      Tipo de gráfico padrão

      Defina um tipo de gráfico padrão (linha, coluna, spline 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 no Hub de análise , 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 de tempo é definida no indicador ou no Hub de análise .

      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 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 30 dias de pontuações em widgets. Você pode substituir este padrão no Hub de análise, Detalhes de KPI, nos widgets do painel ou na visualização de dados do espaço.
      • O IT Live Group é notificado das mudanças no indicador.
      • O indicador é listado em terceiro lugar na 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 no Centro de análise em um espaço configurável.
      • 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 o Detalhes de KPI 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 para previsão, a quantidade de dados históricos para 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 Coleção de teste.
      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 o associe 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é Todos > 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 para 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 o nome.
    5. Salve o detalhamento.
    6. Pressione Coleção de teste.
      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 para o indicador.

    Antes de Iniciar

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

    Procedimento

    1. Navegar até Todos > 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}) GUID DE GROUP BY
      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 Coleção de teste.
      Esta ação testa a instrução SQL que calcula o valor de pontuação para o 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 detalhamentos e indicadores externos

    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é Todos > Performance Analytics > Indicadores Externos ou Performance Analytics > Detalhamentos Externos.
    2. Selecione o indicador ou 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 foram 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 as instruções SQL que coletam pontuações por data.

    No indicador e nas instruções SQL 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 coletada 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 como a data atual.

    Limitações ao usar 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
    • Você não pode exibir pontuações em tempo real
    • Você não pode aplicar detalhamentos de segundo nível
    • Você não pode 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 as mudanças nos registros coletados