Creación de una configuración de agente

Cree una configuración de agente en Logging para ingerir datos de métricas en una métrica personalizada.

Las actualizaciones de configuración del agente se detectan y se cargan automáticamente.

1. En la página de lista Configuraciones de agente en Supervisión, seleccione Crear configuración de agente. Si necesita ayuda para buscar la página de lista, consulte Lista de configuraciones de agente.
2. En el panel Crear configuración de agente, introduzca un nombre y una descripción para la configuración. Evite introducir información confidencial.
3. Seleccione el compartimento en los que desea crear la configuración.
4. En Seleccionar grupos de hosts, en Tipo de grupo, seleccione una opción y, a continuación, seleccione el grupo que desee.
  Por ejemplo, seleccione Grupo dinámico y, a continuación, seleccione el grupo dinámico que coincida con los recursos con las configuraciones de agente.
5. En Configuración de agente, introduzca la URL base para la entrada de métrica.
  
  Por ejemplo, exponga las métricas de una máquina virtual (VM) mediante un punto final HTTP en formato Prometheus:
  
  http://1.2.3.4:9100/metrics
6. Opcionalmente, seleccione Otro punto final para agregar otro punto final.
  Todos los puntos finales van al mismo compartimento y espacio de nombres.
7. En Seleccionar destino de métrica, seleccione el compartimento y el espacio de nombres de métrica en los que desea publicar métricas personalizadas.
8. (Opcional) Agregue una o más etiquetas a la configuración del agente: seleccione Mostrar opciones adicionales para mostrar la sección Agregar etiquetas.
  Si tiene permisos para crear un recurso, también tiene permisos para aplicar etiquetas de formato libre a dicho recurso. Para aplicar una etiqueta defined, debe tener permisos para utilizar el espacio de nombres de la etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si desea aplicar etiquetas, omita esta opción o pregunte a un administrador. Puede aplicar etiquetas más tarde.
9. Seleccione Crear.
La configuración de agente recién creada se muestra en la página Configuraciones de agente.

Utilice el comando oci logging agent-configuration create y los parámetros necesarios para crear una configuración de agente:

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

Comando de ejemplo y archivos 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 obtener una lista completa de parámetros y valores para los comandos de la CLI, consulte la Referencia de comandos de la CLI.

Ejecute la operación CreateUnifiedAgentConfiguration para crear una configuración de agente.

Solicitud de API de ejemplo

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

Documentación de Oracle Cloud Infrastructure

Creación de una configuración de agente