Création d'une configuration d'agent

Créez une configuration d'agent dans Logging pour inclure 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. Sur 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, reportez-vous à Liste des configurations d'agent.
2. Dans le panneau Créer une configuration d'agent, entrez le nom et la description de la configuration. Evitez de saisir des informations confidentielles.
3. Sélectionnez le compartiment dans lesquels créer la configuration.
4. Sous Choisir des groupes d'hôtes, dans Type de groupe, sélectionnez une option, puis le groupe souhaité.
  Par exemple, sélectionnez Groupe dynamique, puis 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'une adresse HTTP au format Prometheus :
  
  http://1.2.3.4:9100/metrics
6. Vous pouvez éventuellement sélectionner Autre adresse pour ajouter une autre adresse.
  Toutes les adresses sont transférées vers le même compartiment et le même espace de noms.
7. Sous Sélectionner une destination de mesure, sélectionnez le compartiment et l'espace de noms de mesure vers lesquels publier des mesures personnalisées.
8. (Facultatif) Ajoutez des balises à la configuration d'agent : sélectionnez Afficher les options supplémentaires pour afficher la section Ajouter des balises.
  Si vous disposez des droits d'accès nécessaires pour créer une ressource, vous disposez également de droits d'accès permettant d'appliquer des balises à format libre à cette ressource. Pour appliquer une balise defined, vous devez disposer des droits d'accès permettant d'utiliser l'espace de noms de balise. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource. Si vous n'êtes pas certain d'appliquer des balises, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des balises ultérieurement.
9. Sélectionnez Create (Créer).
La configuration d'agent que vous venez de créer est répertoriée sur 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 obtenir la liste complète des paramètres et des valeurs des commandes de la CLI, reportez-vous à Référence des commandes de la CLI.

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

Exemple d'API de demande

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

Documentation Oracle Cloud Infrastructure

Création d'une configuration d'agent