Scripts no Performance Analytics

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 5 min. de leitura

    • Performance Analytics fornece vários objetos de script para uso em scripts e APIs para consultar dados Performance Analytics. Os scripts servem como mapeamentos de detalhamento ou para calcular um valor de um indicador.

    Dicas sobre scripts

    • Em geral, use scripts somente para oferecer suporte a indicadores como Idade com processamento de data, usando as variáveis score_start e score_end.
    • Limite os campos desnecessários. Cada vez que você inclui um campo de referência com pontos extra, adiciona uma junção extra à consulta.
    • Tente substituir detalhamentos manuais por exibições de banco de dados para obter melhor desempenho.
    • Tente usar inclusões de script para funções comuns. Para obter mais informações, consulte Inclusões de script.
    • Se os dados não estiverem estruturados da maneira necessária para a emissão de relatórios, tente adicionar "campos de emissão de relatórios" às tabelas operacionais em vez de criar scripts. Para obter mais informações, consulte esta publicação na comunidade.
    • Se você estiver executando um script em segundo plano que consulta as tabelas de pontuações ou snapshots Performance Analytics, não poderá acessar dados sobre uma aplicação com escopo, a menos que tenha uma função apropriada para essa aplicação.
    Aviso:
    Tente não usar GlideRecords ou GlideAggregates em scripts Performance Analytics ou indicadores de fórmula. Embora às vezes você precise usar essas operações para obter o que deseja, elas são caras e podem ser executadas centenas de milhares de vezes. Certifique-se de que não há alternativas antes de usá-las.

    Mapeamento de detalhamento e scripts de indicador

    Um script de mapeamento de detalhamento normalmente retorna um sys_id de um elemento de detalhamento ou um número inteiro para colocar a pontuação em um bucket. Os scripts do indicador retornam uma pontuação calculada a partir de um ou mais campos. O mesmo script pode servir como um script de mapeamento de detalhamento e como um script de indicador.

    Script de detalhamento

    Por exemplo, considere o script Incident.Age.Days fornecido, que usa o campo opened_at da tabela de incidentes. Este script serve como um mapeamento de detalhamento para o detalhamento por Idade, que usa o grupo de buckets Faixas Etárias de Incidentes (Dias) como origem de detalhamento.

    var diff=function(x,y){return y.dateNumericValue() - x.dateNumericValue();};
var days=function(x,y){return diff(x,y)/(24*60*60*1000);};
days(current.opened_at, score_end);

    Neste exemplo, current.opened_at obtém o carimbo de data/hora de quando o registro avaliado no momento foi aberto. A variável de scriptscore_end vem do coletor de dados e está vinculada ao período que está sendo coletado. Por exemplo, se um indicador mensal estiver sendo coletado, o score_end será o fim do mês. Aqui, o carimbo de data/hora de quando o incidente foi aberto é subtraído do carimbo de data/hora do fim do período de coleta e o resultado é convertido para dias.

    Este exemplo inclui o campo Incident.opened_at, que é especificado no campo Campos deste script. Você pode usar score_start e score_end sem defini-los no campo Campos.

    Criar um script no Performance Analytics

    Para criar um script, primeiro selecione a tabela de fatos à qual o script se aplica e selecione explicitamente todos os campos.

    Antes de Iniciar

    Função necessária: admin, pa_admin. Para acessar dados de aplicações com escopo nas tabelas Performance Analytics, você também precisa da função de administrador apropriada para essa aplicação.

    Procedimento

    1. Navegar até Tudo > Performance Analytics > Scripts e clique em Novo.
    2. Dê ao script um Nomedescritivo.
    3. Selecione a tabela Fatos à qual o script se aplica.
      Somente indicadores que usam a mesma tabela de fatos podem usar este script.
    4. Selecione os Camposda tabela de fatos , se houver, que serão usados no script.
      Você seleciona os campos por seus rótulos.
    5. Escreva o script.
      O script deve estar em conformidade com os seguintes relacionamentos e restrições:
      • Você pode incluir somente os campos selecionados neste formulário e variáveis de script. Para obter mais informações, consulte a seção sobre variáveis do Performance Analytics.
      • Ao usar um campo no script, você usa o nome da coluna. Se necessário, pesquise o nome da coluna na tabela de fatos.
      • Ao usar um campo de uma exibição de banco de dados, você deve incluir o prefixo. Por exemplo, a exibição do banco de dados incident_sla inclui a tabela task_sla, com o prefixo taskslatable. Task_sla inclui a coluna business_duration. Para usar o campo business_duration da exibição do banco de dados incident_sla, grave-o como taskslatable_business_duration. Se você não tiver acesso à exibição do banco de dados, peça ao administrador do sistema para encontrar o prefixo para você.

    O que Fazer Depois

    Depois de criar o script, crie um mapeamento de detalhamento ou indicador que use o script. Você pode abrir um mapeamento de detalhamento ou formulário de indicador clicando em Novo no mapeamento de detalhamento ou na guia do indicador. Os mapeamentos de detalhamento e indicadores que usam este script são listados nessas guias.

    Variáveis do Performance Analytics

    Várias variáveis estão disponíveis para uso em Performance Analytics scripts e indicadores de fórmula.

    Você pode usar as seguintes variáveis em Performance Analytics scripts e fórmulas.

    • score_start: primeiro segundo do dia da primeira coleta de pontuação do indicador. Para scripts, o tempo é calculado com base na diferença entre o fuso horário do usuário Executar como para o trabalho de coleta e o fuso horário do banco de dados, que é GMT. Para fórmulas, o tempo é calculado com base na diferença entre o fuso horário do usuário que executa a fórmula e o GMT. Um usuário executa uma fórmula exibindo o indicador de fórmula em um widget de painel ou no Hub de análise.
    • score_end: último segundo do dia da última coleta de pontuação do indicador. O tempo é calculado da mesma forma que para score_start.
    • pa: uma variável de fórmula, não utilizável em scripts, que fornece um conjunto de Hub de análise atributos e métodos.

    Em scripts, as variáveis de início e término da coleção de pontuação são objetos GlideElementGlideObject. Você pode obter um objeto GlideDateTime dessas variáveis chamando getGlideObject(), como neste exemplo: gs.log("Score main = " + score_end.getGlideObject().getDayOfWeek());

    Nas fórmulas, as variáveis de início e término da coleção de pontuação já são objetos GlideDateTime. Portanto, você pode usar as variáveis diretamente sem chamar getGlideObject(), como neste exemplo: gs.log("Score main = " + score_end.getDayOfWeek());

    Os valores das variáveis inicial e final estão vinculados ao período que está sendo coletado. Por exemplo, se um indicador mensal estiver sendo coletado, o score_end será o fim do mês.

    Os valores de score_start e score_end são calculados com base no fuso horário do usuário relevante. Para scripts Performance Analytics, este é o fuso horário Executar como para o trabalho de coleta. Para fórmulas, este é o fuso horário do usuário que exibe o indicador de fórmula em um widget de painel ou o Hub de análise. Portanto, usuários em fusos horários diferentes podem ter datas diferentes para score_start e score_end em uma fórmula.