Install the EKS add-on from AWS marketplace

Amazon Elastic Kubernetes Service (Amazon EKS) is a managed Kubernetes service that makes it easy for you to run Kubernetes both on AWS and on-premises. Kubernetes is an open-source system for automating deployment, scaling, and management of containerized applications. This document walks you through the steps required to use the EKS addon from AWS Marketplace.

Prerequisites

• An Amazon Elastic Kubernetes Service (EKS) cluster. For more information, see our Kubernetes integration: compatibility and requirements and Amazon's user guide.
• A valid New Relic account. You can subscribe to New Relic for free from the AWS marketplace.
• Subscribe to the New Relic Kubernetes integration, also available for free.
• Login to New Relic and generate a license key.

Provision the EKS add-on via the AWS console

1. Navigate to the EKS Cluster > Add-Ons > Get More add-ons.

   

2. Under the AWS Marketplace add-on, search, browse or navigate to New Relic Kubernetes Integration, select the checkbox, and click Next.

   

3. Select the latest default version or choose an alternate version, if required, and click Next.

   

4. Click Create.

Within a few minutes, New Relic's Kubernetes operator should activate and begin running. Please view the configuration steps below to collect and ship observability data from your EKS cluster to New Relic.

Provision EKS add-on via the AWS CLI

Execute the following command to install the NewRelic add-on, with --cluster-name as the name of your EKS cluster.

$
aws eks create-addon --cluster-name REPLACE_ME --addon-name new-relic_kubernetes-operator

You'll receive output similar to the following:

$
{
$
        "addon": {
$
            "addonName": "new-relic_kubernetes-operator",
$
            "clusterName": "newrelic-test",
$
            "status": "CREATING",
$
            "addonVersion": "v0.1.8-eksbuild.1",
$
            "health": {
$
                "issues": []
$
            },
$
            "addonArn": "arn:aws:eks:ap-northeast-2:###############:addon/kubecon2023-127/new-relic_kubernetes-operator/6cc5e7b7-d8f1-5fa0-c668-2bc9727e16b3",
$
            "createdAt": "2023-07-27T11:47:57.023000-07:00",
$
            "modifiedAt": "2023-07-27T11:47:57.044000-07:00",
$
            "tags": {}
$
        }
$
    }

Configure the Kubernetes operator

You can confirm that the Kubernetes operator works by executing kubectl get all -n newrelic at the CLI. To start collecting metrics and ship to New Relic, use the following sample custom resource definition (CRD):

1. Create a crd.yml file using the definitions below, with spec.global.cluster as the name of your EKS cluster and spec.global.licensekey as your New Relic license key.

   apiVersion: newrelic.com/v1alpha1
   kind: NRIBundle
   metadata:
     name: nribundle-sample
   spec:
     global:
       cluster: "<cluster>"
       licenseKey: "<licenseKey>"
       lowDataMode: true
     newrelic-infrastructure:
       enabled: true
       privileged: true
     kube-state-metrics:
       image:
         tag: "v2.10.0"
       enabled: true
     kubeEvents:
       enabled: true
     newrelic-prometheus-agent:
       enabled: true
       lowDataMode: true
       config:
         kubernetes:
           integrations_filter:
             enabled: false

   Copy

2. Once you have updated the desired configuration, upgrade the solution with the following command:

   kubectl apply -f crd.yml -n newrelic

   Copy