Creazione di una configurazione di agente

Creare una configurazione agente nel log per includere i dati delle metriche in una metrica personalizzata.

Gli aggiornamenti della configurazione dell'agente vengono rilevati e caricati automaticamente.

1. Nella pagina elenco Configurazioni agente in Monitoraggio, selezionare Crea configurazione agente. Per assistenza nella ricerca della pagina elenco, vedere Elenca configurazioni agente.
2. Nel pannello Crea configurazione agente, immettere un nome e una descrizione per la configurazione. Evitare di fornire 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 selezionare il gruppo desiderato.
  Ad esempio, selezionare Gruppo dinamico, quindi selezionare il gruppo dinamico che corrisponde alle risorse con le configurazioni 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. Facoltativamente, selezionare Altro endpoint per aggiungere un altro endpoint.
  Tutti gli endpoint passano allo stesso compartimento e allo stesso spazio di nomi.
7. In Seleziona destinazione metrica, selezionare il compartimento e lo spazio di nomi delle metriche 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 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 sei sicuro di applicare i tag, salta questa opzione o chiedi 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 CLI, consultare il manuale CLI Command Reference.

Eseguire l'operazione CreateUnifiedAgentConfiguration per creare una configurazione agente.

Richiesta API di esempio

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>"
}

Documentazione dell'infrastruttura Oracle Cloud

Creazione di una configurazione di agente