Creazione di una configurazione agente

• Console
• CLI
• API

• 1. Nella pagina di elenco Configurazioni agente in Monitoraggio, selezionare Crea configurazione agente. Per informazioni su come trovare la pagina di elenco, vedere Elenco delle configurazioni agente.
  2. Nel pannello Crea configurazione agente immettere un nome e una descrizione per la configurazione. Evitare di inserire informazioni riservate.
  3. Selezionare il compartimento in cui si desidera creare la configurazione.
  4. In Scegli gruppi host, per Tipo di gruppo, selezionare un'opzione, quindi il gruppo desiderato.
     Ad esempio, selezionare Gruppo dinamico, quindi selezionare il gruppo dinamico che corrisponde alle risorse con le configurazioni dell'agente.
  5. In Configurazione agente immettere l'URL di base per l'input della metrica.

     Ad esempio, esporre le metriche da una virtual machine (VM) utilizzando un endpoint HTTP in formato Prometheus:

     http://1.2.3.4:9100/metrics

  6. Se si desidera, selezionare Altro endpoint per aggiungere un altro endpoint.
     Tutti gli endpoint vengono indirizzati allo stesso compartimento e allo stesso spazio di nomi.
  7. In Seleziona destinazione metrica, selezionare lo spazio di nomi del compartimento e della metrica in cui si desidera pubblicare le metriche personalizzate.
  8. (Facoltativo) Aggiungere una o più tag alla configurazione dell'agente: selezionare Mostra opzioni aggiuntive per visualizzare la sezione Aggiungi tag.
     Se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per applicare le tag in formato libero a tale risorsa. Per applicare una tag defined, è necessario disporre delle autorizzazioni per utilizzare la tag namespace. Per ulteriori informazioni sull'applicazione di tag, vedere Tag risorsa. Se non si è certi di applicare le tag, saltare questa opzione o chiedere a un amministratore. È possibile applicare le tag in un secondo momento.
  9. Selezionare Crea.

  La configurazione agente appena creata viene elencata nella pagina Configurazioni agente.

• Utilizzare il comando oci logging agent-configuration create e i parametri necessari per creare una configurazione dell'agente.

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

  Comando di esempio e file 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"
          }
        }
      ]
    }

  Per un elenco completo dei parametri e dei valori per i comandi della CLI, vedere il manuale CLI Command Reference.

• Eseguire l'operazione CreateUnifiedAgentConfiguration per creare una configurazione agente.

  Esempio di richiesta 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>"
  }