Criando uma Configuração do Agente

Crie uma configuração de agente no serviço Logging para ingerir dados de métrica em uma métrica personalizada.

Atualizações de configuração do agente são detectadas e carregadas automaticamente.

1. Na página de lista Configurações do agente em Monitoramento, selecione Criar configuração do agente. Se precisar de ajuda para localizar a página da lista, consulte Listando Configurações do Agente.
2. No painel Criar configuração do agente, informe um nome e uma descrição para a configuração. Evite digitar informações confidenciais.
3. Selecione o compartimento no qual você deseja criar a configuração.
4. Em Escolher grupos de hosts, para Tipo de grupo, selecione uma opção e, em seguida, selecione o grupo desejado.
  Por exemplo, selecione Grupo dinâmico e, em seguida, selecione o grupo dinâmico que corresponde os recursos às configurações do agente.
5. Em Configuração do agente, informe o URL base para a entrada da métrica.
  
  Por exemplo, exponha métricas de uma máquina virtual (VM) usando um ponto final HTTP no formato Prometheus:
  
  http://1.2.3.4:9100/metrics
6. Opcionalmente, selecione Outro ponto final para adicionar outro ponto final.
  Todos os pontos finais vão para o mesmo compartimento e namespace.
7. Em Selecionar destino de métrica, selecione o compartimento e o namespace de métrica para o qual você deseja publicar métricas personalizadas.
8. (Opcional) Adicione uma ou mais tags à configuração do agente: Selecione Mostrar opções adicionais para mostrar a seção Adicionar Tags.
  Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deve ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recursos. Se você não tiver certeza se deseja aplicar tags, ignore essa opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.
9. Selecione Criar.
A configuração do agente recém-criada é listada na página Configurações do Agente.

Use o comando oci logging agent-configuration create e os parâmetros necessários para criar uma configuração de agente:

oci logging agent-configuration create compartment-id compartment_ocid --is-enabled [true|false] --service-configuration service_configuration [OPTIONS]

Exemplo de comando e arquivos JSON

oci logging agent-configuration create --description <description> \
--display-name <display_name> --group-association file://group-association.json \
--compartment-id <compartment_id> --is-enabled true \
--service-configuration file://create-service-configuration.json --wait-for-state SUCCEEDED --max-wait-seconds 60

group-association.json:

{
  "groupList": [
    "<dynamic_group_id>"
  ]
}

create-service-configuration.json:

{
    "configurationType": "MONITORING",
    "applicationConfigurations": [
      {
        "sourceType": "KUBERNETES",
        "source": {
          "name": "KUBERNETES-uniqueid",
          "scrapeTargets": [
            {
              "resourceType": "PODS",
              "k8sNamespace": "k8s-namespace"
            }
          ]
        },
        "destination": {
          "compartmentId": "<compartment_id>",
          "metricsNamespace": "metricsnamespace"
        },
        "filter": {
          "allowList": [
            "regex-test"
          ],
          "denyList": [],
          "filterType": "KUBERNETES_FILTER",
          "name": "test"
        }
      }
    ]
  }

Para ver uma lista completa de parâmetros e valores para comandos CLI, consulte a Referência de Comando CLI.

Execute a operação CreateUnifiedAgentConfiguration para criar uma configuração de agente.

Exemplo da solicitação de API

POST /20200531/unifiedAgentConfigurations
Host: https://logging.us-phoenix-1.oci.oraclecloud.com
<authorization and other headers>
{
  "serviceConfiguration": {
    "configurationType": "MONITORING",
    "applicationConfigurations": [
      {
        "sourceType": "KUBERNETES",
        "source": {
          "name": "KUBERNETES-uniqueid",
          "scrapeTargets": [
            {
              "resourceType": "PODS",
              "k8sNamespace": "k8s-namespace"
            }
          ]
        },
        "destination": {
          "compartmentId": "<compartment_id>",
          "metricsNamespace": "metricsnamespace"
        },
        "filter": {
          "allowList": [
            "regex-test"
          ],
          "denyList": [],
          "filterType": "KUBERNETES_FILTER",
          "name": "test"
        }
      }
    ]
  },
  "displayName": "mar-test",
  "isEnabled": true,
  "groupAssociation": {
    "groupList": [
      "<dynamic_group_id>"
    ]
  },
  "description": "test",
  "compartmentId": "<compartment_id>"
}

Documentação do Oracle Cloud Infrastructure

Criando uma Configuração do Agente