Administrar el contenedor Docker 'ktranslate'

Esta página describe las opciones para la administración del contenedor ktranslate utilizado por el Monitoreo de red de New Relic.

Requisitos del contenedor

Recomendamos los siguientes recursos para la imagen del contenedor ktranslate :

Disk

100 MB de espacio disponible en disco

CPU

Sondeo SNMP/recopilación de trampas: 1 núcleo de CPU dedicado por cada approx. 1000 dispositivos
Colección de flujo de dispositivo: 1 núcleo de CPU dedicado por cada approx. 2000 flujos por segundo (fps)
Colección de mensajes Syslog: 1 núcleo de CPU dedicado por cada approx. 2000 mensajes por segundo

Memory

ktranslate generalmente no está limitado por los recursos de memoria. La cantidad de memoria en su host debe depender de los tipos de aplicación/contenedor que planea ejecutar. Como idea general, normalmente vemos éxito con tamaños de imagen tan pequeños como AWS t2.micro , que tiene 1 vCPU y 1,0 GB de RAM disponible.

Sugerencia

La imagen del contenedor KTranslate ejecuta un único "tipo de trabajo" a la vez. Por ejemplo, un contenedor desplegar para sondeo SNMP y recopilación de trampas no se utilizará para la recopilación de flujo. Además, los contenedores desplegar para la recopilación de flujos están limitados a un único tipo -nf.source por contenedor. Esto significa que es común tener múltiples contenedores implementados en un solo host Docker en un momento dado. También pueden compartir un archivo de configuración común, pero no es necesario.

Actualizando el contenedor

Mantener actualizada la imagen del contenedor ktranslate es una buena práctica para recibir las últimas actualizaciones y resolver problemas comunes mediante varias correcciones de errores aplicadas durante el ciclo de vida de desarrollo. Se recomienda extraer siempre la última imagen disponible al volver a implementar su contenedor.

Extraiga la última imagen de contenedor disponible ejecutando una de las siguientes opciones:
- Docker Hub
  bash
```
$docker pull kentik/ktranslate:v2
```
- Quay.io
  bash
```
$docker pull quay.io/kentik/ktranslate:v2
```
Recopile los ID y nombres de cualquier contenedor existente:
bash
```
$docker ps -a --filter ancestor=kentik/ktranslate:v2 --format "{{.ID}} - {{.Names}}"
```
Ejemplo de salida:
```
3297b134a352 - ktranslate-snmp
4962a854b386 - ktranslate-sflow
```
Retire cualquier contenedor preexistente
bash
```
$docker rm -f $CONTAINER_ID
```
Vuelva a implementar su contenedor ktranslate usando la configuración original con la que implementó desde SNMP, datos de flujo o colección syslog.

Importante

El archivo de configuración utilizado por ktranslate se aplica al contenedor en tiempo de ejecución. Los cambios en este archivo requieren que elimine y reinicie los contenedores en ejecución para aplicar las ediciones, con la excepción del uso de trabajos de descubrimiento integrados.

Opciones de tiempo de ejecución del contenedor

A continuación se muestran las diversas opciones disponibles durante el tiempo de ejecución Docker para la imagen del contenedor ktranslate:

Nombre de la opción	Tipo	Requerido	Descripción
`-snmp`	Bandera	✓	Establece la ruta al archivo `snmp-base.yaml` en el contenedor de la Docker , según el montaje del volumen desde el host de la Docker pasado como opción durante el tiempo de ejecución.
`-nr_account_id`	Bandera	✓	El ID de cuenta de New Relic al que ktranslate enviará los datos.
`-log_level`	Bandera		Anula el nivel de registros predeterminado info para ktranslate. Las opciones disponibles son `debug`, `info`, `warn` o `error`.
`-snmp_discovery`	Bandera		Se utiliza para configurar el contenedor en modo de descubrimiento SNMP para ejecutar un único trabajo de descubrimiento, actualizar el archivo de configuración YAML proporcionado y salir.
`-snmp_discovery_min`	Bandera		Se utiliza para configurar integrated discovery jobs dentro del contenedor de sondeo SNMP programado para ejecutarse en un intervalo fijo. Esta configuración ejecutará el trabajo de descubrimiento, actualizará el archivo de configuración YAML proporcionado y luego reiniciará los subprocesos de recopilación SNMP en el contenedor de sondeo SNMP para eliminar la necesidad de destruir/reiniciar todo el contenedor para los dispositivos descubiertos.
`-snmp_discovery_on_start`	Bandera		Cuando se combina con el indicador `-snmp_discovery_min` configurado, KTranslate ejecutará inmediatamente un trabajo de descubrimiento al iniciar el contenedor, además de cada X minutos según lo definido por `-snmp_discovery_min`. Esta bandera no tiene ningún efecto si no se establece `-snmp_discovery_min` .
`-snmp_poll_now`	Bandera		Se utiliza para configurar el contenedor para sondear un dispositivo objetivo según demanda.
`-tee_logs`	Bandera		Reenvía el registro Docker desde ktranslate a New Relic Logs.
`-metrics=jchf`	Bandera		Reenvía salud métrica desde ktranslate a New Relic.
`-service_name`	Bandera		Se agrega al nombre del contenedor en el registro Docker para ayudar a aislar el registro de varios contenedores en New Relic Logs.
`-nr_region`	Bandera		Establece los extremos regionales de API para que ktranslate reenvíe la telemetría a New Relic. Las opciones son `US`, `EU` y `GOV` (FedRAMP).
`-max_threads`	Bandera		Le permite procesar mayores volúmenes de datos. Recomendamos un núcleo de CPU disponible por cada 2000 flujos por segundo (fps) de datos de flujo de red enviados, o cada 1000 dispositivos SNMP que se monitorean, o cada 2000 mensajes syslog por segundo recopilados por un contenedor. El valor predeterminado es `1`.
`-sample_rate`	Bandera		Cambia el valor de frecuencia de muestreo predeterminado al que se pasan los flujos al evento New Relic . Esto no acelera la configuración local de la frecuencia de muestreo de flujo en un dispositivo, pero puede ralentizarla. Establecer esto en `1` permitirá capturar todos los flujos enviados al contenedor. El valor predeterminado es `1000`.
`-nf.workers`	Bandera		Anula la cantidad de trabajadores utilizados en el procesamiento de paquetes de red. Utilice un trabajador por cada 4000 flujos por segundo (fps) de datos de flujo de red enviados. El valor predeterminado es `2`.
`-nf.port`	Bandera		Anula el puerto de escucha para paquetes de flujo entrantes. El valor predeterminado es `9995`.
`-nf.source`	Bandera		Configura el tipo de flujo que procesará este contenedor. Las opciones son `auto`, `asa`, `ipfix`, `nbar`, `netflow5`, `netflow9`, `pan` y `sflow`.
`-application_map`	Bandera		Establece la ruta a un archivo de mapa de aplicación en el contenedor de la Docker , en función de un montaje de volumen desde el host de la Docker pasado como opción durante el tiempo de ejecución.
`-dns`	Bandera		Establece el `IP:Port` para que ktranslate lo use durante la resolución DNS de direcciones IP. Configurar esto afecta los resultados de los campos `dst_host` y `src_host` .
`nr1.flow`	Argumento	✓ (Para contenedor de flujo)	Este argumento establece estáticamente las siguientes marcas: `compression: gzip`, `sink: new_relic`, `format: new_relic`, `max_before_sample: 100`, `flow_only: true`, `nf.source: auto`.
`nr1.snmp`	Argumento	✓ (Para contenedor SNMP)	Este argumento establece estáticamente las siguientes opciones: `compression: gzip`, `sink: new_relic`, `format: new_relic_metric`, `max_flows_per_message: 100`.
`nr1.syslog`	Argumento	✓ (Para contenedor syslog)	Este argumento establece estáticamente las siguientes marcas: `compression: gzip`, `sink: new_relic`, `format: new_relic_metric`, `syslog:"0.0.0.0:5143"`.
`-syslog.format`	Bandera		Formato para analizar los mensajes de syslog. Las opciones son `Automatic\|RFC3164\|RFC5424\|RFC6587\|NoFormat`. Predeterminado: `Automatic`. `NoFormat` debe configurarse explícitamente para manejar mensajes que no se ajusten a los estándares RFC.
`-syslog.source`	Bandera		IP:Port tupla para ejecutar el servidor Syslog. Por defecto: `0.0.0.0:5143`
`NEW_RELIC_API_KEY`	Variable ambiental	✓	Variable de entorno que se debe utilizar durante el tiempo de Docker ejecución New Relic para ktranslate contener para que envíe datos a la New Relic API. Ej: `-e NEW_RELIC_API_KEY=$LICENSE_KEY`.
`HTTPS_PROXY`	Variable ambiental		Variable de entorno que se puede utilizar durante el tiempo de ejecución Docker para configurar ktranslate para enviar datos a New Relic a través de proxy. Ej: `-e HTTPS_PROXY=https://user:password@hostname:port`.
`KENTIK_PING_PRIV`	Variable ambiental		Variable de entorno que se puede emplear durante el tiempo de ejecución de Docker para configurar ktranslate's `response_time` \| `ping_only` para emplear paquetes UDP empleados en modo sin privilegios en lugar del modo privilegiado predeterminado para paquetes ICMP. Por defecto: `true`
`KENTIK_MERAKI_API_KEY`	Variable ambiental		Variable de entorno que se puede utilizar durante el tiempo de ejecución Docker para pasar la clave de API dashboard de Meraki a ktranslate. Ej: `-e KENTIK_MERAKI_API_KEY=$DASHBOARD_API_KEY`.
Varias variables de entorno del proveedor de la nube	Variable ambiental		Variables de entorno que se pueden usar durante el tiempo de ejecución Docker para recuperar secretos de AWS, Azure o GCP.