Adaptador New Relic métrica

Puede usar métrica desde su cuenta New Relic para escalar automáticamente aplicaciones y servicios en su clúster de Kubernetes implementando el Adaptador métrico New Relic . Este adaptador obtiene los valores métricos de New Relic y los pone a disposición de los Autoscalers pod horizontal.

El newrelic-k8s-metrics-adapter implementa la API external.metrics.k8s.io para admitir el uso de resultados de consulta New Relic NRQL basados en métricas externas. Una vez implementado, el valor de cada métrica configurada se obtiene utilizando la API NerdGraph según la consulta NRQL configurada.

El adaptador métrico expone la métrica sobre un extremo asegurado con TLS.

Requisitos

• Un clúster de Kubernetes que ejecuta una versión compatible.* La integración de New Relic Kubernetes.
• La integración de New Relic Kubernetes.
• New Relic Clave de usuario API de.
• No hay ningún otro Adaptador métrico externo instalado en el clúster.

Instalacion

Para instalar el adaptador métrico New Relic , proporcionamos el newrelic-k8s-metrics-adapter gráfico de Helm, que también se incluye en el gráfico nri-bundle utilizado para desplegar todos los componentes New Relic Kubernetes .

1. Si aún no está instalado, instale nuestra integración de Kubernetes.

2. Actualice la instalación para incluir el Adaptador métrico New Relic con el siguiente comando:

   helm upgrade --install newrelic newrelic/nri-bundle \
   --namespace newrelic --create-namespace --reuse-values \
   --set metrics-adapter.enabled=true \
   --set newrelic-k8s-metrics-adapter.personalAPIKey=YOUR_NEW_RELIC_PERSONAL_API_KEY \
   --set newrelic-k8s-metrics-adapter.config.accountID=YOUR_NEW_RELIC_ACCOUNT_ID \
   --set newrelic-k8s-metrics-adapter.config.externalMetrics.external_metric_name.query=NRQL query

   Copia

Tenga en cuenta y ajuste las siguientes banderas:

• metrics-adapter.enabled: Debe configurarse en true para que se instale la tabla de adaptadores métricos.

• newrelic-k8s-metrics-adapter.personalAPIKey: Debe New Relic configurarse en una clave de API personal de válida.

• newrelic-k8s-metrics-adapter.config.accountID: Debe configurarse en una cuenta New Relic válida de donde se obtendrán las métricas.

• newrelic-k8s-metrics-adapter.config.externalMetrics.external_metric_name.query: Agrega una nueva métrica externa donde:

  • external_metric_name: el nombre de la métrica.
  • query: la consulta NRQL base que se utiliza para obtener el valor de la métrica.

Configuración

Puedes configurar múltiples métricas en el adaptador de métricas y cambiar algún parámetro para modificar el comportamiento del caché y filtrado de métricas. Para ver la lista completa y las descripciones de todos los parámetros que se pueden modificar, consulte el gráfico de los archivos README.md y value.yaml .

Cómo funciona

El siguiente ejemplo es un archivo de valores Helm que habilita el adaptador métrico en la instalación del gráfico nri-bundle y configura la métrica nginx_average_requests :

metrics-adapter:
  enabled: true
newrelic-k8s-metrics-adapter:
  personalAPIKey: <Personal API Key>
  config:
    accountID: <Account ID>
    externalMetrics:
      nginx_average_requests:
        query: "FROM Metric SELECT average(nginx.server.net.requestsPerSecond) SINCE 2 MINUTES AGO"

Hay un HPA que consume la métrica externa de la siguiente manera:

kind: HorizontalPodAutoscaler
apiVersion: autoscaling/v2beta2
metadata:
  name: nginx-scaler
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: nginx
  minReplicas: 1
  maxReplicas: 10
  metrics:
    - type: External
      external:
        metric:
          name: nginx_average_requests
          selector:
            matchLabels:
              k8s.namespaceName: nginx
        target:
          type: Value
          value: 10000

Según la definición de HPA, el administrador del controlador obtiene la métrica de la API métrica externa que es atendida por el adaptador métrico New Relic .

El adaptador métrico New Relic recibe la consulta incluyendo el nombre métrico nginx_average_requests y todos los selectores, y busca un nombre métrico coincidente en la memoria interna en función de la métrica configurada. Luego, agrega los selectores a la consulta para formar una consulta final que se ejecuta usando NerdGraph para obtener el valor de New Relic. El ejemplo anterior generará una consulta como la siguiente:

FROM Metric SELECT average(nginx.server.net.requestsPerSecond) WHERE clusterName=<clusterName> AND `k8s.namespaceName`='nginx' SINCE 2 MINUTES AGO

Observe que se ha agregado automáticamente un filtro clusterName a la consulta para excluir métrica de otros clústeres en la misma cuenta. Puede eliminarlo utilizando el parámetro de configuración removeClusterFilter . Además, el valor se almacena en caché durante un período de tiempo definido por el parámetro de configuración cacheTTLSeconds , cuyo valor predeterminado es 30 segundos.

Resolución de problemas

$
kubectl get --raw "/apis/external.metrics.k8s.io/v1beta1/"

$
kubectl get --raw "/apis/external.metrics.k8s.io/v1beta1/namespaces/*/__METRIC_NAME__?labelSelector=_SELECTOR_KEY_=_SELECTOR_VALUE_"