Documentation sur Oracle Cloud Infrastructure

Création d'une configuration d'agent

Créez une configuration d'agent dans la journalisation pour ingérer les données de mesure dans une mesure personnalisée.

Les mises à jour de configuration d'agent sont détectées et chargées automatiquement.

    1. Dans la page de liste Configurations d'agent sous Surveillance, sélectionnez Créer une configuration d'agent. Si vous avez besoin d'aide pour trouver la page de liste, voir Liste des configurations d'agent.
    2. Dans le panneau Créer une configuration d'agent, entrez un nom et une description pour la configuration. Évitez d'entrer des informations confidentielles.
    3. Sélectionnez le compartiment dans lequel créer la configuration.
    4. Sous Sélectionner des groupes d'hôtes, pour Type de groupe, sélectionnez une option, puis sélectionnez le groupe souhaité.
      Par exemple, sélectionnez Groupe dynamique, puis sélectionnez le groupe dynamique qui correspond aux ressources avec les configurations d'agent.
    5. Sous Configuration de l'agent, entrez l'URL de base de l'entrée de mesure.

      Par exemple, exposez les mesures d'une machine virtuelle à l'aide d'un point d'extrémité HTTP au format Prometheus :

      http://1.2.3.4:9100/metrics
    6. Facultativement, sélectionnez Un autre point d'extrémité pour ajouter un autre point d'extrémité.
      Tous les points d'extrémité vont au même compartiment et au même espace de noms.
    7. Sous Sélectionner la destination de mesure, sélectionnez le compartiment et l'espace de noms de mesure dans lesquels vous voulez publier des mesures personnalisées.
    8. (Facultatif) Ajoutez un ou plusieurs marqueurs à la configuration de l'agent : Sélectionnez Afficher les options supplémentaires pour afficher la section Ajouter des marqueurs.
      Si vous avez l'autorisation de créer une ressource, vous avez également l'autorisation d'appliquer des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour plus d'informations sur le marquage, voir Marqueurs de ressource. Si vous ne savez pas si vous devez appliquer des marqueurs, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des marqueurs plus tard.
    9. Sélectionnez Créer.
    La nouvelle configuration d'agent est répertoriée dans la page Configurations d'agent.

  • Utilisez la commande oci logging agent-configuration create et les paramètres requis pour créer une configuration d'agent :

    oci logging agent-configuration create compartment-id compartment_ocid --is-enabled [true|false] --service-configuration service_configuration [OPTIONS]
    Exemple de commande et de fichiers 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"
        }
      }
    ]
  }

    Pour la liste complète des paramètres et des valeurs pour les commandes de l'interface de ligne de commande, voir .

  • Exécutez l'opération CreateUnifiedAgentConfiguration pour créer une configuration d'agent.

    Exemple de demande d'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>"
}