Criar ou programar um trabalho de coleta de dados

Programe um trabalho de coleta de dados para coletar regularmente Performance Analytics pontuações do indicador e snapshots.

Antes de Iniciar

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

Funções necessárias: pa_data_collector ou admin

Por Que e Quando Desempenhar Esta Tarefa

Os itens importantes a saber ao configurar um trabalho de coleta de dados são:

• Período de coleta
• Fuso horário da coleta
• Domínio de pontuações coletadas, se 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é Todos > 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. No campo Nome, dê um nome significativo ao trabalho.
   Siga um formato padrão para nomear trabalhos do coletor de dados, como [Indicador do PA] Coleta de dados diários, [Indicador do PA] Coleta de dados históricos...
3. No campo Operador, selecione se deseja coletar dados para um período absoluto ou relativo.

   Valor do operador	Descrição
   Corrigidos	Coleta dados para um período absoluto.
   Relativo	Colete dados para um período de tempo que seja relativo ao tempo em que o trabalho é executado.

4. Se você selecionou Fixo como o operador, selecione a Data de início fixa e a Data de término fixa.
5. Se você selecionou Relativo como o 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 no passado para começar a coletar dados.
   2. Nos campos Término relativo e Intervalo de término relativo, defina o número e a duração, respectivamente, do último período no passado para coletar dados.
      Dica:

      • A maioria dos indicadores e, portanto, a maioria dos trabalhos de coleta de dados, é executada diariamente. Os trabalhos programados diariamente normalmente devem ser coletados para o dia concluído mais recentemente. Portanto, eles devem ter um início relativo e um término 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 o intervalo de períodos anteriores. Este intervalo é baseado nos períodos definidos para um calendário de negócios.
      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é anteontem. Para este trabalho, insira 60 em Início relativo e dias atrás em Intervalo de início relativo. Insira 2 em Final relativo e dias atrás em Intervalo de término relativo. Defina o campo Executar como 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 término relativos de 1 dia atrás e defina o campo Executar como 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 os 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 registros Performance Analytics 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á Executar como usuário. Consulte a Etapa 9 neste 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 relatório da sua empresa, se houver. Por padrão, o fuso horário do sistema é usado. Este fuso horário determina que dia é "Hoje" para condições como [[Opened][on][Today]].
   Ativo	Se selecionado, como é por padrão, a coleta de dados ocorre na data e hora programadas.
   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á estas opções para o início e o término do período do calendário comercial (consulte Definir entradas do calendário comercial): Calendário comercial: início da entrada Calendário comercial: fim 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 for Semanalmente, especifique o dia da semana. Se Executar for Mensalmente, especifique o dia do mês. Para coletar no final do mês, defina para o dia 1 e defina a Hora como logo após a meia-noite. Esta configuração coleta dados para um mês concluído, independentemente da duração do mês.
   Intervalo de repetição	Se Executar for definido como Periodicamente, especifique a quantidade de tempo entre as coletas de dados programadas, em dias e hora.
   Iniciando	Se Executar for definido como Periodicamente ou Uma vez, especifique a data e a hora da primeira coleta de dados programada.
   Hora	Hora em que o trabalho é executado, no formato de 24 horas. O campo aparece depois que Ativo é selecionado. Hora baseada no fuso horário da sessão do usuário, não no fuso horário Executar como tz. Geralmente definido para uma hora entre meia-noite e 6h na 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 um de: Pontuações apenas Somente índice de texto Pontuações e índice de texto (padrão) Para obter mais informações, consulte Configurar análise de texto.
   Condicional	Se marcado, a coleta de dados ocorrerá somente se determinadas condições forem atendidas.
   Condições	Script condicional que determina se um trabalho programado deve ser executado. A última expressão do script deve ser avaliada como um valor booliano (verdadeiro/falso). Esta caixa de texto aparecerá somente se você selecionar Usar condições. Aviso: Scripts condicionais para Performance Analytics trabalhos de coleta de dados são executados na área restrita. Portanto, as 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 área restrita 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 "Coletado com erros". Esses trabalhos não coletam pontuações. A propriedade do sistema com.snc.pa.dc.script.use.sandbox 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. Na lista relacionada Indicadores, 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 a manutenção dos trabalhos, 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 o uso de um indicador em tempo real.
   • O trabalho de coleta de dados produz uma consulta de banco de dados para cada origem de indicador dos indicadores associados. Portanto, os dados de todos os indicadores que compartilham uma origem de indicador representam o mesmo ponto no tempo.
9. Se você tiver configurações de domínio habilitadas, poderá selecionar uma configuração de domínio para associar a este trabalho na lista relacionada Configurações de domínio.
   As configurações de domínio são agrupamentos 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 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 o próprio indicador. Para mudar esta configuração de um indicador, consulte Configurar um indicador de trabalho.
• Se você habilitou o suporte de domínio, 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 Criar uma configuração de domínio.