Crie ou programe um trabalho de coleta de dados

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 7 min. de leitura
  • Programe um trabalho de coleta de dados para coletar regularmente Performance Analytics snapshots e pontuações do indicador.

    Antes de Iniciar

    Antes de definir trabalhos de coleta de dados, certifique-se de que as origens do indicador, as origens de detalhamento e os indicadores foram definidos. Caso contrário, os trabalhos não poderão retornar resultados.

    Funções necessárias: pa_data_collector ou administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Os itens importantes a saber quando você configura um trabalho de coleta de dados são:
    • Período de coleta
    • Fuso horário da coleção
    • Domínio de pontuações coletadas, se os domínios forem usados.
    • O trabalho de coleta é executado sem restrições. Ele não usa as permissões do usuário que o executa.

    Os trabalhos de coleta de dados executam etapas diferentes para coletar pontuações e dados de análise de texto. Por padrão, os trabalhos coletam os dois tipos de dados. Para melhorar o desempenho, você pode programar trabalhos separados para pontuações e para dados de análise de texto.

    Procedimento

    1. Navegar até Tudo > Performance Analytics > Coletor de Dados > Trabalhos e clique em Novo .
      Em vez disso, você pode editar um trabalho de coleta de dados existente, por exemplo, para mudar a programação de quando o trabalho é executado. Nesse caso, navegue até Performance Analytics > Coletor de Dados > Trabalhos e clique no nome do trabalho.
    2. Em Nome dê ao trabalho um nome significativo.
      Siga um formato padrão para nomear trabalhos do coletor de dados, como [Indicador de PA] Coleta de dados diários, [Indicador de PA] Coleta de dados históricos...
    3. Em Operador , selecione se deseja coletar dados para um período absoluto ou relativo.
      Valor do operadorDescrição
      Fixo Coleta dados por um período absoluto.
      Relativo Colete dados por um período relativo ao tempo em que o trabalho é executado.
    4. Se você selecionou Corrigido como operador, selecione Início fixo data e Fim fixo data.
    5. Se você selecionou Relativo como operador, especifique os intervalos anteriores ao tempo de execução para coletar dados.
      1. Nos campos Início relativo e. Intervalo de início relativo , defina o número e a duração, respectivamente, de períodos de tempo no passado para começar a coletar dados.
      2. Nos campos Fim relativo e. Intervalo de término relativo , defina o número e o comprimento, respectivamente, do último período no passado do qual coletar dados.
        Dica:
        • A maioria dos indicadores e, portanto, a maioria dos trabalhos de coleta de dados é executada diariamente. Os trabalhos agendados diários normalmente devem ser coletados para o dia concluído mais recentemente. Portanto, eles devem ter um início relativo e um fim relativo de um dia atrás. Execute trabalhos de coleta de dados históricos, que têm períodos de coleta mais longos, apenas uma vez.
        • Se você planeja usar este trabalho com indicadores que usam calendários de negócios, considere períodos atrás intervalo. Este intervalo é baseado nos períodos definidos para um calendário comercial.
        Por exemplo, você deseja coletar pontuações para um conjunto de vários novos indicadores com uma frequência diária, todos usando a mesma origem de indicador. Primeiro, você cria um trabalho de coleta de dados históricos que coleta dados de dois meses atrás até ontem. Para este trabalho, insira 60 em Início relativo e. dias atrás em Intervalo de início relativo . Insira 2 em Fim relativo e. dias atrás em Intervalo de término relativo . Defina o. Executar campo para Sob demanda . Clique em Executar agora e execute este trabalho uma vez para coletar as pontuações iniciais.

        Crie um segundo trabalho com início e fim relativos de 1 dia atrás e defina Executar campo para Diariamente . Ative este trabalho para coletar as pontuações de ontem e todas as pontuações futuras do dia anterior à execução do trabalho.

    6. Preencha Parâmetros do trabalho , conforme apropriado.
      Parâmetro do trabalho Descrição
      Executar como Para instâncias separadas por domínio, selecione o usuário que executa este trabalho. O trabalho coleta pontuações da tabela de fatos e. Performance Analytics Registros que têm o domínio Global ou estão no domínio deste usuário.

      O trabalho de coleta de dados segue somente o domínio, não as permissões deste usuário. ACLs e regras de negócios não se aplicam a trabalhos de coleta de dados. Qualquer usuário pode executar o trabalho.

      Importante:
      Se você selecionar uma configuração de domínio para este trabalho, ela substituirá o. Executar como usuário. Consulte a Etapa 9neste tópico.
      Executar como tz Selecione o fuso horário que as consultas usam quando são executadas a partir do trabalho. Use o fuso horário de emissão de relatórios da sua empresa, se houver um. Por padrão, o fuso horário do sistema é usado.

      Este fuso horário determina qual dia é "hoje" para condições como [[Aberto][em][Hoje]].

      Ativo Se selecionado, como está por padrão, a coleta de dados ocorre na data e hora agendadas.
      Executar Selecione a programação para coletar os dados. As opções são:
      • Diariamente
      • Semanalmente
      • Mensalmente
      • Periodicamente
      • Uma vez
      • Sob demanda
      Se você estiver usando calendários comerciais, também terá essas opções para o início e o fim do período do calendário comercial (consulte Defina entradas do calendário comercial ):
      • Calendário comercial: Início da entrada
      • Calendário comercial: Término da entrada

      Se você estiver criando um trabalho de coleta de dados históricos, programe o trabalho para ser executado sob demanda.

      Dia
      • Se Executar é Semanalmente , especifique o dia da semana.
      • Se Executar é Mensal , especifique o dia do mês.

      Para coletar no final do mês, defina para o dia 1 e defina Tempo para logo depois da meia-noite. Esta configuração coleta dados de um mês concluído, independentemente da duração do mês.

      Intervalo de repetição Se Executar é Periodicamente , especifique a quantidade de tempo entre as coletas de dados agendadas, em dias e horas.
      Iniciando Se Executar é Periodicamente ou Uma vez , especifique a data e a hora da primeira coleta de dados agendada.
      Hora Tempo em que o trabalho é executado, no relógio de 24 horas. O campo aparece após Ativo está selecionado.
      • Hora baseada no fuso horário da sessão do usuário, não no Executar como tz fuso horário.
      • Geralmente definido para uma hora entre meia-noite e 6 am em sua empresa, para coletar o último período completo.

      Por exemplo, se você estiver em Nova York e quiser coletar dados às 5 da manhã para sua empresa que está no horário de Los Angeles, defina a hora como 08:00:00.

      Coletar Os trabalhos de coleta de dados têm etapas separadas para coletar pontuações e para coletar análise de texto. Selecione uma das seguintes opções:
      • Pontuações apenas
      • Somente índice de texto
      • Pontuações e índice de texto (padrão)

      Para obter mais informações, consulte Configure a análise de texto.

      Condicional Se marcada, a coleta de dados ocorrerá somente se determinadas condições forem atendidas.
      Condições Um script condicional que determina se um trabalho agendado deve ser executado. A última expressão do script deve ser avaliada como um valor booliano (verdadeiro/falso). Esta caixa de texto será exibida somente se você selecionar Condições de uso .
      Aviso:
      Scripts condicionais para Performance Analyticsos trabalhos de coleta de dados são executados na sandbox. Portanto, definições de função não são permitidas. Algumas chamadas de API e palavras-chave também não são permitidas. Para obter mais informações, consulte Propriedade da sandbox de script .

      Após o upgrade, os trabalhos com scripts condicionais que contêm esses componentes de API não permitidos serão concluídos com "Coletados com erros". Esses trabalhos não coletam pontuações.

      . com.snc.pa.dc.script.use.sandbox a propriedade do sistema controla se os scripts de coleta de dados usam a área restrita. Somente usuários com a função security_admin podem modificar esta propriedade. Tenha cuidado ao desativar esta propriedade. Quando definido como falso, usuários não autorizados podem executar ações mal-intencionadas em sua instância.

    7. Clique com o botão direito no cabeçalho do formulário e selecione Salvar.
    8. Em Indicadores lista relacionada, clique em Editar e selecione os indicadores para os quais este trabalho coleta dados.
      Importante:
      • Inclua pelo menos um indicador para o trabalho. Caso contrário, o trabalho não poderá retornar resultados.
      • Para ajudar a manter os trabalhos passíveis de manutenção, tente não associar um indicador a mais de um trabalho de coleta ativo, a menos que você tenha um caso de uso claro. Se você estiver tentando obter dados em tempo real, considere usar um indicador em tempo real.
      • O trabalho de coleta de dados produz uma consulta de banco de dados para cada origem de indicador para os indicadores associados. Assim, os dados de todos os indicadores que compartilham uma origem de indicador representam o mesmo point-in-time.
    9. Se você tiver habilitado configurações de domínio, poderá selecionar uma configuração de domínio para associar a este trabalho no Configurações de domínio lista relacionada.
      As configurações de domínio são o agrupamento de domínios com base em sua visibilidade para um grupo de usuários ou outra condição. Esses agrupamentos podem incluir relacionamentos primário-secundário. Se você selecionar uma configuração de domínio para um trabalho, o trabalho coletará pontuações para registros nos domínios da configuração, incluindo o domínio global. As configurações de domínio substituem o. Executar como usuário. Para obter mais informações, consulte Agrupando domínios em Performance Analytics configurações de domínio.
    10. Clique em Enviar.

    O que Fazer Depois

    • Por padrão, para cada indicador de trabalho, os dados são coletados para todos os detalhamentos e para o próprio indicador. Para alterar esta configuração de um indicador, consulte Configure um indicador de trabalho.
    • Se você tiver habilitado o suporte a domínios, você terá uma lista relacionada chamada Configuração de domínio . Nesta guia, clique em Editar para relacionar uma configuração de domínio existente a este trabalho ou clique em Novo para criar uma nova configuração de domínio. Para obter mais informações, consulte Crie uma configuração de domínio.