• /
  • EnglishEspañolFrançais日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Configuración del Agent Control con Terraform

|View as Markdown (English)

El Control de agentes de New Relic con Terraform proporciona una solución potente y declarativa para gestionar flotas de agentes a escala. Al usar Terraform y el Control de agentes de forma conjunta, puede garantizar un enfoque coherente, repetible y escalable para desplegar la instrumentación de New Relic en toda la infraestructura, especialmente al tratar con múltiples clústeres de Kubernetes.

Requisitos previos

Antes de comenzar, cerciorar de tener lo siguiente:

Sugerencia

Al configurar un nuevo clúster con Terraform, asegúrese de usar el mismo nombre de clúster durante la instalación del Control de agentes.

Compatibilidad con Kubernetes

Para saber qué versiones de Kubernetes son compatibles con esta solución, consulte la sección de compatibilidad en la descripción general.

Instalar

Si no tiene clientId y clientSecret, emplee la siguiente llamada API de NerdGraph para generarlos. Esto requiere su clave de usuario administrador de New Relic y el ID de la organización.

bash
$
curl -X POST \
>
https://api.newrelic.com/graphql \
>
-H 'Content-Type: application/json' \
>
-H 'x-api-key: [INSERT_USER_API_KEY]' \
>
--data-raw '{"query": "mutation SICreate { systemIdentityCreate(name: \"User Key for Agent Control\" organizationId: \"[INSERT_YOUR_ORG_ID]\") { clientId clientSecret } }"}' \
>
--compressed

En el comando, reemplace los valores de marcador de posición con su organizationId y su clave de usuario. Esto devuelve las credenciales requeridas que empleará en su archivo de configuración.

Paso 1: Crea tu directorio de proyectos

Crea un directorio para tu proyecto y coloca tu archivo main.tf dentro de él. Aquí es donde definirás tus recursos de Terraform. Confirme que agregó el proveedor Helm a su archivo Terraform.

Paso 2: Configurar Terraform con la versión Helm

Configure su script de Terraform con una versión de Helm que emplee los gráficos de New Relic para el control del agente. El siguiente ejemplo muestra una configuración básica:

provider "helm" {
kubernetes {
config_paths = [
"~/.kube/config"
]
}
}
resource "helm_release" "newrelic" {
name = "agent-control"
repository = "https://newrelic.github.io/helm-charts/"
chart = "agent-control"
namespace = "newrelic"
create_namespace = "true"
values = [
file("./values-newrelic.yaml")
]
}

Tenga en cuenta que el script de Terraform hace referencia a un archivo values-newrelic.yaml . Este es el archivo de configuración de Agent Control de New Relic que se empleará para configurar el Agent Control. No es necesario que esté en el mismo directorio que el script de Terraform. Puede hacer referencia a él desde cualquier ubicación proporcionando la ruta correcta en la función file() dentro del atributo de valores del recurso helm_release .

O bien, si coloca el archivo values-newrelic.yaml directamente en el directorio del proyecto Terraform, el script main.tf hará referencia a él automáticamente.

A continuación se muestra un ejemplo de un archivo values-newrelic.yaml básico sin configuración adicional incluida:

global:
cluster: [YOUR_CLUSTER_NAME]
licenseKey: [YOUR_INGEST_LICENSE_KEY]
agentControlDeployment:
chartValues:
systemIdentity:
organizationId: [ORG_ID]
parentIdentity:
clientId: [YOUR_IDENTITY_CLIENT_ID]
clientSecret: [YOUR_IDENTITY_CLIENT_SECRET]
config:
fleet_control:
# optional
fleet_id: [YOUR_FLEET_ENTITY_GUID]
log:
level: trace

Para explorar todas las configuraciones disponibles, consulte values-newrelic.yaml.

Paso 3: Ejecutar comandos de Terraform

Inicialice Terraform, revise el plan y aplique los cambios.

bash
$
# Initialize Terraform
$
terraform init
bash
$
# Review the changes before applying
$
terraform plan
bash
$
# Apply the changes to your cluster
$
terraform apply

Paso 5: Verificar la instalación

Verifique que el pod de control del agente y cualquier agente configurado se estén ejecutando correctamente en sus respectivos espacios de nombres.

bash
$
# Check Agent Control pods
$
kubectl get pods -n newrelic
bash
$
# Check pods in the agent namespace, e.g., 'newrelic-agents'
$
kubectl get pods -n newrelic-agents

Configuración

En el archivo values-newrelic.yaml , puede configurar el agente Control para desplegar múltiples agentes de monitoreo. A continuación se muestra un ejemplo que muestra la implementación de varios agentes, incluidos:

  • Infrastructure: agente de infraestructura de New Relic
  • Logs: Agente de registros de Fluent Bit
  • OpenTelemetry: La distribución New Relic del Collector OpenTelemetry
  • Gateway: Agente de puerta de enlace de New Relic Pipeline Control
agentControlDeployment:
chartValues:
systemIdentity:
organizationId: "****"
parentIdentity:
clientId: [YOUR_IDENTITY_CLIENT_ID]
clientSecret: [YOUR_IDENTITY_CLIENT_SECRET]
config:
agents:
infrastructure:
agent_type: newrelic/com.newrelic.infrastructure:0.1.0
logs:
agent_type: newrelic/io.fluentbit:0.1.0
agent-operator:
agent_type: com.newrelic.k8s_agent_operator:0.1.0
open-telemetry:
agent_type: newrelic/com.newrelic.opentelemetry.collector:0.1.0
gateway:
agent_type: newrelic/com.newrelic.pipeline_control_gateway:0.1.0
agentsConfig:
infrastructure:
chart_version: "*"
chart_values:
newrelic-infrastructure:
enableProcessMetrics: true
logs:
# Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/newrelic-logging`
# Recommended: check and define an explicit chart version (latest stable)
chart_version: "*"
chart_values:
newrelic-logging:
sendMetrics: true
agent-operator:
chart_version: "*"
open-telemetry:
# Ref: `https://github.com/newrelic/helm-charts/blob/master/charts/nr-k8s-otel-collector/values.yaml`
# Recommended: check and define an explicit chart version (latest stable)
chart_version: "*"
chart_values:
nr-k8s-otel-collector:
receivers.filelog.enabled: false
gateway:
chart_version: "*"
chart_values:
gateway:
autoscaling:
minReplicas: 2
maxReplicas: 10
targetCPUUtilizationPercentage: 70

Importante

Importante: Para el entorno de producción, recomendamos encarecidamente emplear un chart_version específico fijado en lugar de un comodín (*). Esto garantiza actualizaciones consistentes y previsibles, evitando comportamientos inesperados o cambios radicales.

Desinstalar

Importante

Eliminar un recurso de lanzamiento de Helm de su configuración de Terraform es una acción destructiva. Cuando ejecute terraform apply luego de este cambio, Terraform desinstalará el gráfico y destruirá todos los recursos relacionados, lo que podría provocar la pérdida de datos. Antes de continuar, cerciorar de comprender completamente el impacto potencial en su entorno:

  • Revisar todas las dependencias y servicios que pudieran ver afectados.
  • Considere realizar una copia de seguridad de cualquier dato persistente o configuración vinculada a la versión.
  • Confirme que eliminar esta versión es necesario y se ajusta a su estrategia de gestión de infraestructura. Tenga siempre cuidado al realizar cambios significativos en su infraestructura y cerciorar de tener procedimientos de reversión adecuados en caso de que algo salga mal.

Para desinstalar Agente Control:

  1. Elimine el bloque de recursos helm_release para newrelic_agent_control de su archivo main.tf .
  2. Ejecute terraform plan para revisar los cambios. Examine cuidadosamente el resultado del plan para cerciorar de que solo los recursos previstos estén marcados para su eliminación.
  3. Ejecute terraform apply y confirme la ejecución para desinstalar la versión. Esto implementará los cambios planeados y eliminará efectivamente la versión de Helm especificada de su entorno.

Confirme la ejecución cuando aparezca el símbolo para completar el proceso de desinstalación.

Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.