Configurar a telemetria para o modelo de PLA

uim902
HID_ESD_PLA_TELEMETRY
A telemetria é um elemento fundamental do modelo de PLA (Portfolio License Agreement – Contrato de Licença de Portfólio) do software corporativo. O requisito inicial do esforço da telemetria é coletar e relatar o uso específico de produto diariamente em apoio ao novo modelo de consumo.A Broadcom usa seu próprio terminal para oferecer suporte à distribuição de telemetria para software corporativo. Esse terminal fornece uma plataforma centralizada para a coleta e o roteamento dos dados de uso por meio de várias integrações e destinos predefinidos.
Um cliente com um PLA de software corporativo deve ativar a telemetria e compartilhar os dados de uso. Este artigo descreve como ativar a telemetria e rotear os dados de uso para a Broadcom.
Conteúdo:
Dados coletados pela telemetria
A telemetria coleta dois tipos de detalhe para cada cliente do PLA:
  • Dados do cliente:
    Esses dados identificam o cliente, seu site pela ID do site e uma ID de cobrança opcional para identificar a divisão ou o grupo a ser cobrado pelo uso. Para isso, você deve configurar os detalhes do cliente no arquivo
    esdplatelemetry_customerinfo.properties
    .
  • Dados de uso:
    Esses são os dados de uso real com base no consumo, que são coletados e compartilhados na API da Broadcom. Você deve ativar o upload dos dados de uso no arquivo
    wasp.cfg
    . Para obter mais informações sobre como ativar os uploads de telemetria, consulte Ativar uploads de telemetria.
Os dados de telemetria coletados são armazenados em: 'probes/service/wasp/esdplatelemetry/'.
Os dados do cliente e de uso são compartilhados pela API para fins de relatórios internos.
A telemetria não coleta PII (Personally Identifiable Information - Informações de Identificação Pessoal) ou informações confidenciais. Para obter mais informações sobre como suas informações são coletadas e usadas, leia nossa declaração de privacidade.
Frequência da coleta de dados
Por padrão, a telemetria coleta e armazena os dados diariamente às 00:00. Se o agendador não estiver ativo às 00:00, os dados serão coletados somente na execução do dia seguinte. Os dados são coletados somente uma vez ao dia.
Ativar uploads da telemetria
Pré-requisito
Certifique-se de que o
serviço web uimesdplatelemetry
esteja implantado no wasp uimserver.
Etapa 1: Definir os detalhes do cliente no arquivo
esdplatelemetry_customerinfo.properties
  1. Copie o arquivo
    wasp/conf/esdplatelemetry_customerinfo.properties.template
    em
    wasp/conf/esdplatelemetry_customerinfo.properties
    .
  2. Edite o arquivo
    wasp/conf/esdplatelemetry_customerinfo.properties
    e defina as seguintes propriedades com as informações de cliente adequadas:
    1. domain_name
      : o nome do domínio do cliente.
    2. site_id
      : ID do site do cliente. Para encontrar a ID do cliente, efetue logon no site de Suporte da Broadcom e veja as informações de ID do site de cliente no seu perfil.
    3. pla_enabled
      : defina o valor como true ou false para determinar se uma instalação ou atualização está relacionada ao uso incremental como resultado do PLA. Entre em contato com a equipe de vendas da Broadcom para obter mais detalhes sobre uma instalação ser incremental ou não.
    4. (Opcional)
      chargeback_id
      : defina a divisão ou o grupo a ser cobrado pelo uso de consumo relatado à broadcom.com. Definir os detalhes de cobrança é útil ao entender em qual ambiente do Unified Infrastructure Management o relatório se origina.
Etapa 2: Configurar as propriedades da telemetria no wasp
É possível configurar as propriedades de telemetria usando uma das seguintes opções:
  • Atualizar as propriedades em wasp.cfg ou
  • Atualizar as propriedades no Gerenciador de infraestrutura ou
  • Atualizar as propriedades no Console de administração
Atualizar as propriedades no arquivo wasp.cfg
  1. Edite o arquivo ./wasp.cfg e defina os parâmetros a seguir em
    <webapps>
    1. esdplatelemetryconfig.upload_enabled_flag
      : é obrigatório que todos os clientes de PLA definam esta propriedade como
      true
      para que façam upload dos dados para a Broadcom. Por padrão, o sinalizador está definido como
      false
      .
    2. (Opcional)
      esdplatelemetryconfig.proxy_url
      : define o URL para o servidor proxy a partir do UIM Server. Por exemplo: esdplatelemetryconfig.proxy_url = http://testproxy:8080
    3. (Opcional)
      esdplatelemetryconfig.proxy_auth_username
      : configure o nome de usuário autenticado usando apenas o IM (Infrastructure Manager - Gerenciador de infraestrutura) ou o AC (Administration Console - Console de administração). Para obter mais informações, consulte Atualizar as propriedades no Gerenciador de infraestrutura e Atualizar as propriedades no Console de administração.
    4. (Opcional)
      esdplatelemetryconfig.proxy_auth_password
      : configure a senha autenticada usando apenas o Gerenciador de infraestrutura (IM) ou o Console de administração (AC). Para obter mais informações, consulte Atualizar as propriedades no Gerenciador de infraestrutura e Atualizar as propriedades no Console de administração.
      Não configure os parâmetros
      esdplatelemetryconfig.proxy_auth_username
      e
      esdplatelemetryconfig.proxy_auth_password
      no arquivo wasp.cfg. Isso resulta em falha na autenticação do proxy e na perda de cargas transmitidas para a Broadcom.
    5. (Opcional)
      esdplatelemetryconfig.envtype
      : se desejar substituir o terminal padrão em que os dados são carregados, especifique o valor apropriado para o tipo de ambiente. Por padrão, o valor é
      prod
      . Você pode alterar o valor, por exemplo, para
      qa
      .
<webapps> <uimesdplatelemetry> path = /uimesdplatelemetry load_on_startup = true reloadable = true cross_context = true reinitialize = true unpack_war = true <custom> <uncrypted> customerinfo.properties_filepath = ./conf/esdplatelemetry_customerinfo.properties esdplatelemetryconfig.upload_enabled_flag = true esdplatelemetryconfig.proxy_url = esdplatelemetryconfig.proxy_auth_username = esdplatelemetryconfig.envtype = prod usage_metering_address = usage_metering </uncrypted> <crypted> esdplatelemetryconfig.proxy_auth_password = </crypted> </custom> </uimesdplatelemetry></webapps>
Atualizar as propriedades no Gerenciador de infraestrutura
  1. No Gerenciador de infraestrutura, clique duas vezes no wasp para abrir a UI de configuração do wasp.
  2. Vá para o aplicativo web
    uimesdplatelemetry
    .
  3. Clique com o botão direito do mouse em
    uimesdplatelemetry
    e selecione
    Editar
    .
  4. Vá para a guia
    Personalizado
    .
  5. Atualize e salve os valores das propriedades relacionadas à telemetria:
    1. esdplatelemetryconfig.upload_enabled_flag
      : é obrigatório que todos os clientes de PLA definam esta propriedade como
      true
      para que façam upload dos dados para a Broadcom. Por padrão, o sinalizador está definido como
      false
      .
    2. (Opcional)
      esdplatelemetryconfig.proxy_url
      : define o URL para o servidor proxy a partir do UIM Server. Por exemplo: esdplatelemetryconfig.proxy_url = http://testproxy:8080
    3. (Opcional)
      esdplatelemetryconfig.proxy_auth_username
      : defina o nome de usuário de autenticação para acessar o proxy
    4. (Opcional)
      esdplatelemetryconfig.proxy_auth_password
      : defina a senha de autenticação para acessar o proxy
    5. (Opcional)
      esdplatelemetryconfig.envtype
      : se desejar substituir o terminal padrão em que os dados são carregados, especifique o valor apropriado para o tipo de ambiente. Por padrão, o valor é
      prod
      . Você pode alterar o valor, por exemplo, para
      qa
      .
  6. Selecione
    OK
    para sair da caixa de diálogo de propriedades.
A captura de tela a seguir mostra os parâmetros obrigatórios e alguns dos parâmetros opcionais que estão sendo definidos:
im_properties_telemetry.png
Atualizar as propriedades no Console de administração
  1. No Console de administração, vá para o wasp e clique em Configurar no menu de contexto para abrir a UI de configuração do wasp.
  2. Vá para aplicativos web e selecione
    uimesdplatelemetry
    .
  3. No painel de propriedades, vá para a seção
    Propriedades
    personalizadas
    .
  4. Atualize os valores das propriedades que estão relacionadas à telemetria e, em seguida, selecione
    Salvar
    :
    1. esdplatelemetryconfig.upload_enabled_flag
      : é obrigatório que todos os clientes de PLA definam esta propriedade como
      true
      para que façam upload dos dados para a Broadcom. Por padrão, o sinalizador está definido como
      false
      .
    2. (Opcional)
      esdplatelemetryconfig.proxy_url
      : define o URL para o servidor proxy a partir do UIM Server. Por exemplo: esdplatelemetryconfig.proxy_url = http://testproxy:8080
    3. (Opcional)
      esdplatelemetryconfig.proxy_auth_username
      : defina o nome de usuário de autenticação para acessar o proxy
    4. (Opcional)
      esdplatelemetryconfig.proxy_auth_password
      : defina a senha de autenticação para acessar o proxy
    5. (Opcional)
      esdplatelemetryconfig.envtype
      : se desejar substituir o terminal padrão em que os dados são carregados, especifique o valor apropriado para o tipo de ambiente. Por padrão, o valor é
      prod
      . Você pode alterar o valor, por exemplo, para
      qa
      .
A captura de tela a seguir mostra os parâmetros obrigatórios e alguns dos parâmetros opcionais que estão sendo definidos:
ac_properties_telemetry.png
Etapa 3: reiniciar o wasp
Reinicie o wasp uimserver para o serviço web uimesdplatelemetry a fim de inicializar usando os valores de configuração recém-criados.
Solucionar problemas
Caso haja erros, revise o arquivo
uimesdplatelemetry.log
armazenado no diretório 'probes/service/wasp/'.O serviço web executa uma validação na inicialização, e os erros serão registrados, se a configuração contiver erros. Os uploads são realizados uma vez por dia, à meia-noite. É recomendável revisar o arquivo de log no dia seguinte para uma validação final.