Configuración de minion privado en contenedores (llamadas por minuto)

Importante

A partir del 26 de agosto de 2024, ya no podrás crear un nuevo monitor usando tiempos de ejecución legacy en ubicaciones públicas o privadas.

El 22 de octubre de 2024, dejaremos de funcionar el minion privado en contenedor (llamadas por minuto) y las versiones legacy de tiempo de ejecución sintética que admite. Revise nuestros pasos de migración recomendados para evitar la degradación de su monitor de ubicación privada.

Este documento lo guía a través de la configuración de su minion privado en contenedores (CPM).

Puedes hacer lo siguiente para personalizar tus llamadas por minuto:

Emplee variables de entorno para configurar su minion privado en contenedores.
Configure módulos personalizados para API con script o monitor browser con script .
Conserve los datos de lanzamiento con almacenamiento de datos permanente.

No puede modificar ningún archivo de llamadas por minuto y New Relic no es responsable de las modificaciones que realice.

configuración usando variables de entorno

Las variables ambientales le permiten ajustar la configuración de llamadas por minuto para satisfacer sus necesidades ambientales y funcionales específicas.

Las variables se proporcionan al inicio utilizando el argumento -e, --env .

La siguiente tabla muestra todas las variables de entorno que admite llamadas por minuto. MINION_PRIVATE_LOCATION_KEY es obligatorio y todas las demás variables son opcionales.

Nombre	Descripción
`MINION_PRIVATE_LOCATION_KEY`	REQUIRED. UUID de la ubicación privada, tal como se encuentra en la página web de ubicación privada.
`DOCKER_API_VERSION`	Formato: `"vX.Y"` versión de API que se utilizará con el servicio Docker determinado. Por defecto: `v1.35.`
`DOCKER_HOST`	Apunta al minion a un `DOCKER_HOST` determinado. Si está ausente, el valor predeterminado es `/var/run/docker.sock.`
`MINION_API_ENDPOINT`	Para cuentas con sede en EE. UU., el extremo es: `https://synthetics-horde.nr-data.net.` Para cuentas basadas en la UE , el extremo es: `https://synthetics-horde.eu01.nr-data.net/` Cerciorar de que sus CPM puedan conectarse al extremo apropiado para servir a su monitor.
`MINION_DOCKER_RUNNER_REGISTRY_ENDPOINT`	El registro y la organización Docker donde se aloja la imagen minion Runner. Utilícelo para anular `quay.io/newrelic` como valor predeterminado (por ejemplo, `docker.io/newrelic`).
`MINION_API_PROXY`	Formato: `"host:port"`.
`MINION_API_PROXY_AUTH`	Formato: `"username:password"` : admite autenticación básica HTTP + protocolos de autenticación adicionales compatibles con Chrome.
`MINION_API_PROXY_SELF_SIGNED_CERT`	Valores aceptables: `true`, `1` o `yes` (cualquier caso).
`MINION_CHECK_TIMEOUT`	La cantidad máxima de segundos que se permite que se ejecuten las comprobaciones de su monitor. Este valor debe ser un número entero entre `0 seconds (excluded)` y `900 seconds (included)` (por ejemplo, de 1 segundo a 15 minutos). Valor predeterminado: `65 seconds` para el monitor de ping, `180 seconds` para los otros tipos monitor .
`MINION_DOCKER_API_VERSION`	Sinónimo de `DOCKER_API_VERSION`.
`MINION_DOCKER_HOST`	Sinónimo de `DOCKER_HOST.`
`MINION_RUNNER_APPARMOR (CPM version > 3.0.2)` `OR` `MINION_DOCKER_RUNNER_APPARMOR (CPM version <= 3.0.2)`	El nombre del perfil de AppArmor, si se ha aplicado al contenedor Docker que ejecuta el script de monitor (por ejemplo, Docker Runner). El nombre del perfil de AppArmor debe existir y estar configurado en la máquina para funcionar.
`MINION_JVM_MB`	Valor predeterminado: `"2560"` (2,5 GB).
`MINION_JVM_OPTS`	Pasa opciones de línea de comando a la JVM interna. Consulte la documentación de Java de Oracle para obtener más información. Por defecto: `-server.`
`MINION_LOG_LEVEL`	Al comunicarse con el soporte de New Relic, es posible que le soliciten que aumente esto a `"DEBUG"` o `"TRACE"`. Por defecto: `INFO.`
`MINION_NETWORK_HEALTHCHECK_DISABLED (CPM version >= 3.0.11)`	El estado deshabilitado minion Network Healthcheck, para gestionar las CPM y verificar el acceso público a Internet. El valor predeterminado es "falso", cuando se establece como "verdadero", las CPM omitirán esta verificación de estado.
`MINION_USER_DEFINED_ENV_VARIABLES`	Formato: Ejemplo. Un conjunto alojado localmente de pares de valores principales definidos por el usuario.
`MINION_HEAVY_WORKERS`	La cantidad de trabajadores que el minion utilizará para ejecutar trabajos pesados (`BROWSER`, `SCRIPT_BROWSER`, `SCRIPT_API`). Si no está definido, el minion usará `NUM_CPUS` donde `NUM_CPUS` es la cantidad de CPU disponibles para el minion. El valor máximo permitido para esta variable es `50`. Para obtener más información sobre los tipos monitor , consulte Tipos de monitor Sintético.
`MINION_LIGHTWEIGHT_WORKERS`	La cantidad de trabajadores que utilizará el minion para ejecutar trabajos livianos (`SIMPLE` trabajos de ping). Si no está definido, el minion usará `25 * NUM_CPUS` donde `NUM_CPUS` es la cantidad de CPU disponibles para el minion. El valor máximo permitido para esta variable es `1250`. Para obtener más información sobre los tipos monitor , consulte Tipos de monitor Sintético.
`MINION_VSE_PASSPHRASE`	Si se establece, habilita verified script execution y utiliza este valor como passphrase.

Las variables se proporcionan al inicio utilizando el argumento --set .

La siguiente lista muestra todas las variables de entorno que admite llamadas por minuto. synthetics.privateLocationKey es obligatorio y todas las demás variables son opcionales.

Nombre	Descripción
`synthetics.privateLocationKey`	REQUIRED if `synthetics.privateLocationKeySecretName` is not set. UUID/clave de ubicación privada de la ubicación privada, tal como se encuentra en la página web de la ubicación privada.
`synthetics.privateLocationKeySecretName`	REQUIRED if `synthetics.privateLocationKey` is not set. Nombre del secreto de Kubernetes que contiene la clave `privateLocationKey`, que contiene la clave de autenticación asociada a tu ubicación privada de Sintético.
`replicaCount`	Número de réplicas a mantener con su instalación StatefulSet Por defecto: `1.`
`imagePullSecrets`	El nombre del objeto secreto utilizado para extraer una imagen de un registro de contenedor específico.
`fullnameOverride`	Anulación de nombre utilizada para su instalación `StatefulSet` , reemplazando el valor predeterminado.
`appVersionOverride`	Versión de lanzamiento de llamadas por minuto para usar en lugar de la versión especificada en chart.yml.
`synthetics.minionLogLevel`	Si se comunica con el soporte de New Relic, es posible que le soliciten que aumente esto a `"DEBUG"` o `"TRACE"`. Por defecto: `INFO.`
`synthetics.heavyWorkers`	La cantidad de trabajadores simultáneos que utilizará el minion para ejecutar trabajos pesados (`BROWSER`, `SCRIPT_BROWSER`, `SCRIPT_API`). Si no está definido, el minion usará el valor `2`. El valor máximo permitido para esta variable es `50`. Para obtener más información sobre los tipos monitor , consulte Tipos de monitor Sintético.
`synthetics.lightweightWorkers`	La cantidad de trabajadores que utilizará el minion para ejecutar trabajos livianos (`SIMPLE` trabajos de ping). Si no está definido, el minion usará `25 * synthetics.heavyWorkers`, donde `synthetics.heavyWorkers` es el número definido en la variable de entorno anterior. El valor máximo permitido para esta variable es `1,250`. Para obtener más información sobre los tipos monitor , consulte Tipos de monitor Sintético.
`synthetics.minionApiEndpoint`	Para cuentas con sede en EE. UU., el extremo es: `https://synthetics-horde.nr-data.net.` Para cuentas basadas en la UE , el extremo es: `https://synthetics-horde.eu01.nr-data.net/` Cerciorar de que sus CPM puedan conectarse al extremo apropiado para servir a su monitor.
`synthetics.minionDockerRunnerRegistryEndpoint`	El registro y la organización Docker donde se aloja la imagen minion Runner. Utilice esto para anular `quay.io/newrelic` como valor predeterminado (por ejemplo, `docker.io/newrelic`).
`synthetics.minionVsePassphrase`	Si se establece, habilita verified script execution y utiliza este valor como passphrase.
`synthetics.minionVsePassphraseSecretName`	Si está configurado, habilita la ejecución de script verificada y utiliza este valor para recuperar la frase de contraseña de un secreto de Kubernetes con una clave llamada minionVsePassphrase.
`synthetics.minionApiProxy`	Formato: `"host:port"`.
`synthetics.minionApiProxySelfSignedCert`	Valores aceptables: `true`, `1` o `yes` (cualquier caso).
`synthetics.minionApiProxyAuth`	Formato: `"username:password"` : admite autenticación básica HTTP + protocolos de autenticación adicionales compatibles con Chrome.
`synthetics.minionCheckTimeout`	La cantidad máxima de segundos que se permite que se ejecuten las comprobaciones de su monitor. Este valor debe ser un número entero entre `0 seconds (excluded)` y `900 seconds (included)` (por ejemplo, de 1 segundo a 15 minutos). Valor predeterminado: `65 seconds` para el monitor de ping, `180 seconds` para los otros tipos monitor .
`synthetics.minionUserDefinedEnvVariable`	Formato: Ejemplo. Un conjunto alojado localmente de pares de valores principales definidos por el usuario.
`synthetics.minionJVMOpts`	Pasa opciones de línea de comando a la JVM interna. Por defecto: `-server -XX:-UsePerfData`
`synthetics.minionNetworkHealthCheckDisabled (CPM version >= 3.0.11)`	El estado deshabilitado minion Network Healthcheck, para gestionar las CPM y verificar el acceso público a Internet. El valor predeterminado es "falso", cuando se establece como "verdadero", las CPM omitirán esta verificación de estado.
`image.repository`	El contenedor para tirar. Por defecto: `quay.io/newrelic/synthetics-minion`
`image.pullPolicy`	La política de atracción. Por defecto: `IfNotPresent`
`persistence.claimName`	El nombre del PVC a utilizar. Si no está definido o no está configurado, `Statefulset` creará dinámicamente un PVC para cada réplica.
`persistence.storageClass`	Anula `StorageClass` para `VolumeClaimTemplates`, relevante solo si `claimName` no está definido o está vacío. Para obtener más detalles, consulte volúmenes persistentes.
`persistence.accessMode`	Modo de acceso que se definirá para el PVC, relevante solo si `claimName` no está definido o está vacío. Predeterminado: `ReadWriteOnce`.
`persistence.annotations`	Anotaciones para agregar al PVC, relevantes solo si `claimName` no está definido o está vacío.
`persistence.size`	Tamaño que se definirá para el PVC, relevante solo si `claimName` no está definido o está vacío. Predeterminado: `10Gi`.
`persistence.permanentData`	Ruta en el volumen al directorio de almacenamiento de datos permanente. Para obtener más detalles, consulte almacenamiento permanente de datos.
`persistence.customModules`	Ruta en el volumen al directorio de módulos personalizados. Para obtener más detalles, consulte módulos personalizados.
`persistence.userDefinedVariables`	Ruta en el volumen al archivo `user-defined-variable.json` . Para obtener más detalles, consulte variables definidas por el usuario.
`serviceAccount.create`	Si es verdadero, se crea una cuenta de servicio y se asigna al despliegue. Predeterminado: `false`.
`serviceAccount.name`	La cuenta de servicio que se asignará al despliegue. Si `serviceAccount.create` es verdadero, entonces este nombre se utiliza al crear la cuenta de servicio.
`serviceAccount.annotations`	Las anotaciones que se agregarán a la cuenta de servicio si `serviceAccount.create` está configurado en `true`.
`removeJobsLog`	Kubernetes predeterminado no incluye un recursolog /trabajos. Establezca esto en `true` para eliminarlo de la función si es necesario. Predeterminado: `false`.
`headlessService.serviceName`	El nombre del servicio sin cabeza que se asociará con `StatefulSet`. Si no se establece, se genera un nombre utilizando la plantilla de nombre completo.
`appArmorProfileName`	El nombre del perfil `AppArmor` que se aplicará al minion y al grupo Runner. Si está configurado, el perfil de AppArmor debe existir en los nodos de Kubernetes para que esto funcione.
`podSecurityContextRunAsUser`	Un UID que se puede configurar en `0 (root)` o entre `[2000, 4000]`, inclusive. Si está configurado, ejecuta las llamadas por minuto como el UID dado. Predeterminado: `2379`.

Directrices para montar volúmenes

A todos los directorios y archivos must se les asignará propiedad de grupo como 3729 con licencias de lectura/escritura. Esto garantiza que el Runner, que emplea uid: 1000 y gid: 3729, tenga acceso a todos los volúmenes montados. Sin embargo, el minion puede ejecutar como root (uid: 0) o con cualquier uid entre el rango de [2000, 4000], inclusive. Para obtener más información, consulte Ejecutar como no root en Kubernetes o Docker.

Docker

Los directorios se montan en un contenedor como volúmenes especificando un argumento -v dentro docker run
Por ejemplo, docker run ... -v /path/to/src:/path/to/dest:rw

Kubernetes

Es posible agregar un directorio a un volumen persistente (PV) usando kubectl cp. Sin embargo, se admiten enfoques alternativos siempre que los permisos de archivo estén configurados adecuadamente.
Por ejemplo, kubectl cp /path/to/src <POD_NAME>:/path/to/dest agregará un directorio a cada PV en el pod especificado
Cada PV debe tener una copia separada de los directorios. Por ejemplo, un clúster con n réplicas minion debe tener n PV, cada uno con su propia copia de directorios.
Los directorios y archivos deben agregar antes del inicio del minion ; de lo contrario, se debe resetear el minion para detectar las actualizaciones.

Módulos de nodo personalizados

Los módulos de nodos personalizados son exclusivos de las llamadas por minuto. Le permiten proporcionar un conjunto arbitrario de módulos de nodo y ponerlos a disposición para el monitor con script en el monitoreo sintético.

Para configurar los módulos:

Cree un directorio que contenga un package.json, siguiendo las pautas oficiales de npm, en la raíz del directorio. Todo lo contenido en el campo dependencies será instalado por las CPM al inicio y estará disponible cuando se ejecute el monitor en ese minion privado.
Opcionalmente, puede anular el nivel raíz package.json con un directorio específico de la versión de Node.js. Esto permite actualizar un script por tiempo de ejecución del monitor si una versión Node.js de un tiempo de ejecución ya no es compatible con su dependencia. Vea un ejemplo de esto a continuación.
En este ejemplo, se utiliza un directorio de módulo personalizado con la siguiente estructura:
/example-custom-modules-dir/ ├── counter │ ├── index.js │ └── package.json └── package.json ⇦ the only mandatory file
package.json define dependencies como un módulo local (por ejemplo, counter) y cualquier módulo alojado (por ejemplo, async versión ^2.6.1):
{ "name": "custom-modules", "version": "1.0.0", ⇦ optional "description": "example custom modules directory", ⇦ optional "dependencies": { "async": "^2.6.1", ⇦ hosted module "counter": "file:./counter" ⇦ local module } }
Puede declarar un package.json por versión de Node.js que anulará el nivel raíz package.json. Esto permite que un monitor script se actualice por monitor tiempo de ejecución en el caso de que la versión Node.js de un tiempo de ejecución ya no sea compatible con su dependencia. Como se muestra en el primer ejemplo, los módulos locales aún se pueden definir dentro de un directorio específico de la versión. Si no se define un package.json para una versión específica de Node.js, entonces se usará el nivel raíz package.json para instalar la dependencia.
En este ejemplo, se utiliza un directorio de módulo personalizado con la siguiente estructura:
/example-custom-modules-dir/ ├── 6.11.2 ⇦ optional Node.js specific directory │ └── package.json └── 10.15.0 ⇦ optional Node.js specific directory │ └── package.json ├── counter │ ├── index.js │ └── package.json └── package.json ⇦ the only mandatory file
Una vez que cree el directorio de módulos personalizados y el package.json, podrá aplicarlo a sus llamadas por minuto para Docker y Kubernetes.
Para Docker, lanza llamadas por minuto montando el directorio en /var/lib/newrelic/synthetics/modules. Por ejemplo:
bash
$docker run ... -v /example-custom-modules-dir:/var/lib/newrelic/synthetics/modules:rw ...
Complete lo siguiente:
lanza las llamadas por minuto, estableciendo un valor para el valor de configuración persistence.customModules ya sea en la línea de comando o en un archivo YAML durante la instalación. El valor debe especificar la subruta en el volumen persistente de su minion donde existen sus archivos de módulos personalizados. Por ejemplo:
bash
$helm install ... --set persistence.customModules=CUSTOM_MODULES_SUBPATH ...
Cerciorar de que su directorio de módulos personalizados esté disponible en el minion pod. Puede emplear kubectl cp como método para copiar el directorio de su host al minion. Por ejemplo:
bash
$kubectl cp /example-custom-modules-dir NAMESPACE/POD_NAME:/var/lib/newrelic/synthetics/modules
Mire el registro de llamadas por minuto de "... Initialization of Custom Modules ..." para ver si los módulos se instalaron correctamente o si hubo algún error. Se mostrará el registro de instalación de npm.

Ahora puede agregar "require('async');" al script del monitor que envía a esta ubicación privada.

Cambiar `package.json`

También puede emplear módulos de Node.js junto con módulos locales y alojados. Para cambiar los módulos personalizados empleados por tus CPM, modifica package.json y resetear las CPM. Detectará el cambio en la configuración durante el resetear y luego lo limpiará y lo reinstalará.

Advertencia

Módulos locales: si bien su package.json puede incluir cualquier módulo local, estos módulos deben residir dentro del árbol bajo su directorio de módulos personalizados. Si se almacena fuera del árbol, el proceso de inicialización fallará y verá un mensaje de error en el registro de Docker después de iniciar llamadas por minuto.

Almacenamiento permanente de datos

llamadas por minuto es una aplicación sin estado y no conserva información de solicitudes o sesiones anteriores de forma predeterminada. Sin embargo, puede conservar los datos entre lanzamientos habilitando el almacenamiento permanente de datos. Por ejemplo, puede establecer permanentemente cómo se identifica el minion (por ejemplo, Minion_ID) y usarlo para asociar esos datos con el minion exacto que lo produjo.

Para configurar el almacenamiento permanente de datos en Docker:

Crea un directorio.
lanza las llamadas por minuto, montando el directorio en /var/lib/newrelic/synthetics.
Ejemplo:
bash
```
$docker run ... -v /example-permanent-dir:/var/lib/newrelic/synthetics:rw ...
```

Para configurar el almacenamiento de datos permanente en Kubernetes:

lanza las llamadas por minuto, estableciendo un valor para el valor de configuración persistence.permanentData ya sea en la línea de comando o en un archivo YAML durante la instalación. El valor debe especificar la subruta en el volumen persistente de su minion donde desea que se guarden los datos.
Ejemplo:
bash
```
$helm install ... --set persistence.permanentData=PERMANENT_DATA_SUBPATH ...
```

Variables de entorno definidas por el usuario para monitor con script

Minion privado en contenedores le permite configurar variables de entorno para usar en un monitor con script. Estas variables están alojadas localmente en llamadas por minuto y se puede acceder a ellas a través de $env.USER_DEFINED_VARIABLES. Hay dos formas de configurar variables definidas por el usuario: montando un archivo JSON o proporcionando una variable de entorno a las llamadas por minuto en el lanzamiento. Si se proporcionan ambos, las llamadas por minuto utilizarán únicamente los valores proporcionados por el entorno.

El archivo JSON debe tener permisos de lectura y contener un mapa con formato JSON.

Ejemplo de archivo de variables definido por el usuario:

{
  "KEY": "VALUE",
  "User_Name": "MINION",
  "My_Password": "PASSW0RD 1 2 3",
  "my_URL": "https://newrelic.com/",
  "ETC": "ETC"
}

El archivo debe estar disponible o montado en la ruta de su contenedor:

/var/lib/newrelic/synthetics/variables/user_defined_variables.json

Ejemplo Docker:

bash

$docker run ... -v /example-user-defined-variables.json:/var/lib/newrelic/synthetics/variables/user_defined_variables.json:rw ...

Ejemplo de Kubernetes:

Al montar un archivo JSON en su minion pod en Kubernetes, puede copiar el archivo directamente en el minion pod o en un pod que tenga acceso al mismo volumen persistente y reclamación de volumen persistente que minion usará el . Después de cargar exitosamente el archivo, es posible que tengas que reiniciar tu minion pod para que el cambio surta efecto.

bash

$kubectl cp path/to/user_defined_variables.json NAMESPACE/POD_NAME:/var/lib/newrelic/synthetics/variables/user_defined_variables.json

Utilice la bandera -e para configurar una variable de entorno denominada MINION_USER_DEFINED_VARIABLES y asígnele un valor de una cadena de mapa con formato JSON.

bash

$docker run ... -e MINION_USER_DEFINED_ENV_VARIABLES='{"KEY":"VALUE","NAME":"MINION","ETC":"ETC"}' ...

Sugerencia

Las llamadas por minuto en Kubernetes actualmente no admiten la carga de variables de entorno definidas por el usuario a través de la variable de entorno. Tendrás que configurar tus llamadas de Kubernetes por minuto montando un archivo JSON.

Acceder a variables de entorno definidas por el usuario desde un script

Para hacer referencia a una variable de entorno configurada definida por el usuario, utilice el $env.USER_DEFINED_VARIABLES reservado seguido del nombre de una variable determinada con notación de puntos.

Por ejemplo, $env.USER_DEFINED_VARIABLES.MY_VARIABLE

Advertencia

Las variables de entorno definidas por el usuario no se desinfectan del registro. Para información confidencial, considere utilizar la característica de credenciales seguras .

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

Configuración de minion privado en contenedores (llamadas por minuto)

Importante

configuración usando variables de entorno

Configuración del entorno Docker

Configuración del entorno de Kubernetes

Directrices para montar volúmenes

Módulos de nodo personalizados

Directorio de módulos personalizados

Anulaciones específicas de la versión de Node.js

Docker

Kubernetes

Cambiar `package.json`

Advertencia

Almacenamiento permanente de datos

Variables de entorno definidas por el usuario para monitor con script

Montaje del archivo JSON

Pasando como una variable de entorno

Sugerencia

Acceder a variables de entorno definidas por el usuario desde un script

Advertencia

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

Configuración de minion privado en contenedores (llamadas por minuto)

Importante

configuración usando variables de entorno .css-21sua1{background:none;border:none;width:0;padding:0;}

Configuración del entorno de Kubernetes

Directrices para montar volúmenes

Módulos de nodo personalizados

Directorio de módulos personalizados

Anulaciones específicas de la versión de Node.js

Docker

Kubernetes

Cambiar package.json

Advertencia

Almacenamiento permanente de datos

Variables de entorno definidas por el usuario para monitor con script

Montaje del archivo JSON

Pasando como una variable de entorno

Acceder a variables de entorno definidas por el usuario desde un script

Advertencia

configuración usando variables de entorno

Cambiar `package.json`