Como adicionar um novo grupo de análise

Edge para nuvem privada v4.18.05

Quando você instala o Edge para nuvem privada, por padrão, o instalador cria um único grupo de análise chamado "axgroup-001". No momento da instalação, é possível mudar o nome padrão do grupo de análise incluindo a propriedade AXGROUP no arquivo de configuração da instalação:

# Specify the analytics group.
# AXGROUP=axgroup-001          # Default name is axgroup-001.

Consulte Instalar componentes do Edge em um nó para saber mais.

Se quiser adicionar um novo grupo de análises à sua instalação, faça o seguinte:

  1. Crie e configure o novo grupo de análise:
    1. Crie o grupo de análise, chamado axgroupNew:
      curl -u sysAdminEmail:passWord -H "Content-Type: application/json"
        -X POST 'https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew'
    2. Adicione um grupo de consumidores ao novo grupo de análise, chamado consumer-group-new. Os nomes dos grupos de consumidores são exclusivos no contexto de cada grupo de análise:
      curl -u sysAdminEmail:passWord -X POST -H 'Accept:application/json'
        -H 'Content-Type:application/json'
        "https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/consumer-groups?name=consumer-group-new"
    3. Defina o tipo de consumidor do grupo de análise como "ax":
      curl -u sysAdminEmail:passWord -X POST -H "Content-Type:application/json"
        "https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/properties?propName=consumer-type&propValue=ax"
    4. Adicione o nome do data center. Por padrão, você instala o Edge com um data center chamado "dc-1". No entanto, se você tiver vários data centers, cada um deles terá um nome exclusivo. Essa chamada é opcional se você tiver apenas um data center e recomendada se tiver vários data centers:
      curl -u sysAdminEmail:passWord -X POST -H "Content-Type:application/json"
        "https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/properties?propName=region&propValue=dc-1"
  2. Adicione os UUIDs dos servidores Postgres ao novo grupo de análise. Se você tiver configurado dois servidores Postgres para funcionar como um par mestre/reserva, especifique ambos como uma lista de UUIDs separados por vírgulas.
    1. Para conferir os UUIDs dos servidores do Postgres, execute o seguinte comando cURL em cada nó do servidor do Postgres:
      curl -u sysAdminEmail:passWord https://PG_IP:8084/v1/servers/self
    2. Se você tiver apenas um servidor Postgres, adicione-o ao grupo de análise:
      curl -u sysAdminEmail:passWord -H "Content-Type: application/json"
        -X POST 'https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/servers?uuid=UUID&type=postgres-server&force=true'

      Se você tiver vários servidores Postgres configurados como um par mestre/reserva, adicione-os especificando uma lista de UUIDs separados por vírgulas:

      curl -u sysAdminEmail:passWord -H "Content-Type: application/json"
        -X POST 'https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/servers?uuid=UUID_Master,UUID_standby&type=postgres-server&force=true'

      Esse comando retorna as informações sobre o grupo de análise, incluindo o UUID do servidor Postgres na propriedade postgres-server em uuids:

      {
        "name" : "axgroupNew",
        "properties" : {
          "region" : "dc-1",
          "consumer-type" : "ax"
        },
        "scopes" : [ ],
        "uuids" : {
          "qpid-server" : [ ],
          "postgres-server" : [ "2cb7211f-eca3-4eaf-9146-66363684e220" ]
        },
        "consumer-groups" : [ {
          "name" : "consumer-group-new",
          "consumers" : [ ],
          "datastores" : [ ],
          "properties" : {
          }
        } ],
        "data-processors" : {
        }
      }

    3. Adicione o servidor Postgres ao repositório de dados do grupo de consumidores. Essa chamada é necessária para rotear mensagens de análise dos servidores Qpid para os servidores Postgres:
      curl -u sysAdminEmail:passWord -X POST -H 'Accept:application/json'
        -H 'Content-Type:application/json'
        "https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/consumer-groups/consumer-group-new/datastores?uuid=UUID"

      Se vários servidores Postgre estiverem configurados como um par mestre/reserva, adicione-os especificando uma lista de UUIDs separados por vírgulas:

      curl -u sysAdminEmail:passWord -X POST -H 'Accept:application/json'
        -H 'Content-Type:application/json'
        "https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/consumer-groups/consumer-group-new/datastores?uuid=UUID_Master,UUID_standby"

      O UUID aparece na propriedade datastores do consumer-groups na saída.

  3. Adicione os UUIDs de todos os servidores Qpid ao novo grupo de análise. É necessário realizar esta etapa para todos os servidores Qpid.
    1. Para conferir os UUIDs dos servidores Qpid, execute o comando cURL a seguir em cada nó do servidor Qpid:
      curl -u sysAdminEmail:passWord https://QP_IP:8083/v1/servers/self
    2. Adicione o servidor Qpid ao grupo de análise:
      curl  -u sysAdminEmail:passWord -H "Content-Type: application/json"
        -X POST 'https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/servers?uuid=UUID&type=qpid-server'
    3. Adicione o servidor Qpid ao grupo de consumidores:
      curl  -u sysAdminEmail:passWord -X POST -H 'Accept:application/json'
        -H 'Content-Type:application/json'
        "https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/consumer-groups/consumer-group-new/consumers?uuid=UUID"

      Essa chamada retorna o seguinte, em que é possível ver o UUID do servidor Qpid adicionado à propriedade qpid-server em uuids e à propriedade consumers em consumer-groups:

      {
        "name" : "axgroupNew",
        "properties" : {
          "region" : "dc-1",
          "consumer-type" : "ax"
        },
        "scopes" : [ ],
        "uuids" : {
            "qpid-server" : [ "fb6455c3-f5ce-433a-b98a-bdd016acd5af" ],
            "postgres-server" : [ "2cb7211f-eca3-4eaf-9146-66363684e220" ]
        },
        "consumer-groups" : [ {
          "name" : "consumer-group-new",
          "consumers" : [ "fb6455c3-f5ce-433a-b98a-bdd016acd5af" ],
          "datastores" : [ "2cb7211f-eca3-4eaf-9146-66363684e220" ],
          "properties" : {
          }
        } ],
        "data-processors" : {
        }
      }

  4. Provisione uma organização e um ambiente para o novo grupo do AX:
    curl -u sysAdminEmail:passWord -H "Content-Type: application/json"
      -X POST "https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/scopes?org=org_name&env=env_name"