Nuestra integración Elasticsearch recopila y envía inventario y métricas de su clúster Elasticsearch a nuestra plataforma, donde podrá ver el estado de su entorno Elasticsearch. Recopilamos métricas a nivel de clúster, nodo e índice para que pueda encontrar más fácilmente el origen de cualquier problema.
Para instalar la integración de monitoreo de Elasticsearch, siga los siguientes pasos:
- Instalar y activar la integración.
- Configurar la integración.
- Buscar y utilizar datos.
- Opcionalmente, consulte los ajustes de configuración de Elasticsearch.
Compatibilidad y requisitos
Versiones de Elasticsearch
Nuestra integración es compatible con Elasticsearch 7.x a 8.X.
Sistema operativo soportado
Windows
linux
Para obtener una lista completa de versiones específicas de Windows y Linux, consulte la tabla de sistemas operativos compatibles.
Requisito del sistema
Una cuenta New Relic . ¿No tienes uno? ¡Registrate gratis! No se requiere tarjeta de crédito.
Si Elasticsearch no se ejecuta en Kubernetes o Amazon ECS, instale el agente de infraestructura en un host que ejecute Elasticsearch. De lo contrario:
Si está funcionando
Si está funcionando
Instalar y activar la integración.
Para instalar la integración de Elasticsearch, siga las instrucciones para su entorno:
Instalación de linux
Siga las instrucciones para instalar una integración y reemplace la variable
INTEGRATION_FILE_NAME
connri-elasticsearch
.Cambie el directorio a la carpeta de configuración de integración ejecutando:
bash$cd /etc/newrelic-infra/integrations.dCopie el archivo de configuración de muestra ejecutando:
bash$sudo cp elasticsearch-config.yml.sample elasticsearch-config.ymlEdite el archivo de configuración
elasticsearch-config.yml
con su editor favorito. Consulte algunos ejemplos de archivos de configuración.Para habilitar el análisis de errores de Elasticsearch automático y el reenvío, copie (o cambie el nombre) el archivo
elasticsearch-log.yml.example
aelasticsearch-log.yml
. No es necesario reiniciar el agente.
Example
$sudo cp /etc/newrelic-infra/logging.d/elasticsearch-log.yml.example /etc/newrelic-infra/logging.d/elasticsearch-log.yml
Otros ambientes
Notas adicionales:
Advanced:
integración también están disponibles en formato tarball para permitir la instalación fuera de un administrador de paquetes.
On-host integrations do not automatically update.
Para obtener mejores resultados, actualice periódicamente el paquete de integración y el agente de infraestructura.
¿Te ha ayudado este documento con la instalación?
Configurar la integración
Hay varias formas de configurar la integración, dependiendo de cómo se instaló:
Si se habilita a través de
Si se habilita a través de
Si está instalado en el host, edite la configuración en el archivo de configuración YAML de la integración,
elasticsearch-config.yml
. La configuración de formato YAML de una integración es donde puede colocar las credenciales de inicio de sesión requeridas y configurar cómo se recopilan los datos. Las opciones que cambie dependen de su configuración y preferencia. El archivo de configuración tiene configuraciones comunes aplicables a todas las integraciones, comointerval
,timeout
,inventory_source
. Para leer todo sobre estas configuraciones comunes, consulte nuestro documento de formato de configuración .
Importante
Si todavía utiliza nuestros archivos de configuración o definición legacy, verifique el formato de configuración estándar.
Archivos de muestra elasticsearch-config.yml
Opciones de configuración para la integración.
Para obtener más información sobre cómo encontrar y utilizar sus datos, consulte los ajustes de configuración de Elasticsearch.
Buscar y utilizar datos
Los datos de este servicio se informan a un dashboard de integración.
Los datos de Elasticsearch se adjuntan a los siguientes tipos de eventos:
Puede consultar estos datos para fines de resolución de problemas o para crear gráficos y paneles personalizados.
Para obtener más información sobre cómo encontrar y utilizar sus datos, consulte cómo entender los datos de integración.
Métrica recogida por la integración
La integración Elasticsearch recoge la siguiente métrica. Cada nombre de métrica tiene como prefijo un indicador de categoría y un punto, como cluster.
o shards.
.
La integración de Elasticsearch es un software de código abierto. Eso significa que puedes explorar su código fuente y enviar mejoras, o crear tu propia bifurcación y compilarla.
Configuración de la instancia de Elasticsearch
Puede utilizar la sección env
del archivo elasticsearch-config.yml
para definir configuraciones específicas relacionadas con Elasticsearch. Estas configuraciones controlan la conexión a su instancia de Elasticsearch, así como otras configuraciones y características de seguridad.
La integración Elasticsearch recopila información tanto métrica como de inventario. En la tabla, utilice la columna Applies to para las configuraciones disponibles para cada colección:
' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '
Configuración | Descripción | Por defecto | Se aplica a |
---|---|---|---|
HOSTNAME | Nombre de host o IP donde se ejecuta Elasticsearch. | host local | M/I |
LOCAL_HOSTNAME | Nombre de host o IP del nodo Elasticsearch del cual recopilar datos de inventario. Solo debe configurarse si no desea recopilar datos de inventario en localhost. | host local | M |
PORT | Puerto en el que escucha Elasticsearch. | 9200 | M/I |
USERNAME | Nombre de usuario para acceder al nodo Elasticsearch. | N/A | M/I |
PASSWORD | Contraseña para el usuario dado. | N/A | M/I |
CLUSTER_ENVIRONMENT | Una forma de especificar más para qué clúster estamos recopilando datos, por ejemplo: 'de prueba'. | N/A | M/I |
USE_SSL | Utilice SSL cuando se comunique con el nodo Elasticsearch. | false | M/I |
CA_BUNDLE_FILE | Ubicación del certificado SSL en el host. Solo es necesario si | N/A | M/I |
CA_BUNDLE_DIR | Directorio de paquete de autoridad de certificación alternativa. | N/A | M/I |
SSL_ALTERNATIVE_HOSTNAME | Nombre de servidor alternativo que la integración aceptará como válido para fines de negociación SSL. | N/A | M/I |
TLS_INSECURE_SKIP_VERIFY | Omita la verificación de la cadena de certificados y el nombre de host del servidor. | false | M/I |
CONFIG_PATH | Ruta al archivo de configuración de Elasticsearch. | /etc/elasticsearch/ | I |
TIMEOUT | Tiempo de espera para solicitudes de API, en segundos. | 30 | M/I |
COLLECT_INDICES | Señaliza si recoger índices métricos o no. | verdadero | M |
COLLECT_PRIMARIES | Indica si se deben recoger primarias métricas o no. | verdadero | M |
INDICES_REGEX | Filtrar qué índices se recopilan. | N/A | M |
MASTER_ONLY | Recoja el clúster métrico únicamente en el maestro elegido. | false | M |
METRICS | Establezca en | false | |
INVENTORY | Configúrelo en | false |
Los valores para estas configuraciones se pueden definir de varias maneras:
- Agregando el valor directamente en el archivo de configuración. Esta es la forma más común.
- Reemplazar los valores de las variables de entorno usando la notación
{{ }}
. Lea más sobre el uso de transferencias de variables de entorno con integración en el host o vea el ejemplo para el reemplazo de variables de entorno.Importante
Esto requiere el agente de infraestructura v1.14.0+. - Utilizando la gestión de secretos. Utilícelo para proteger información confidencial, como contraseñas que quedarían expuestas en texto sin formato en el archivo de configuración. Para obtener más información, consulte gestión de secretos.
Etiquetas y atributos personalizados
Puedes decorar aún más tu métrica usando etiquetas. Las etiquetas le permiten agregar valor par principal atributo a su métrica, que luego puede usar para consultar, filtrar o agrupar su métrica.
El archivo de muestra de configuración básica elasticsearch-config.yml incluye el uso de etiquetas. Sin embargo, como no son obligatorios, puedes eliminar, modificar o agregar nuevos a tu elección.
labels: env: production role: load_balancer
Datos de inventario
La integración Elasticsearch captura el parámetro de configuración del nodo Elasticsearch, como se especifica en el archivo de configuración YAML. También recopila información de configuración del nodo del extremo \_nodes/\_local
. Los datos están disponibles en la página de inventario de infraestructura, en la fuente config/elasticsearch
.
Para obtener más información sobre los datos de inventario, consulte cómo comprender los datos de integración.