macOS Quick Start

Instructions for installing the Free Edition Edge Delta agent on macOS.

  3 minute read  

You can install the Edge Delta Free Edition agent on a local Kubernetes cluster hosted on your macOS system. This process involves setting up a new Kubernetes cluster, creating an Edge Delta account, and installing the Edge Delta agent in your new cluster. After installing the agent, you can Set Up Alerts.

Create a Desktop Kubernetes Cluster

This example uses Homebrew to install Docker, Helm and kind. Then kind is used to create a local Kubernetes cluster.

  1. Install Homebrew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. Install Docker Desktop:
brew install --cask docker
  1. Install Kind:
brew install kind
  1. Install Helm:
brew install helm
  1. Start Docker Desktop:
open -a docker
  1. Create a Kubernetes cluster:
kind create cluster

Create an Edge Delta Account

Next, create an Edge Delta user account.

  1. Click Login on the edgedelta.com website.
  2. Click Sign up.
  3. Enter your details in the Account Details page and click Register. Alternatively, click Sign up with Google.
  4. Check your email and Activate your account.
  5. If a user with the same domain name as your email address has created an organization you can click it to request to join it and wait for their approval. Otherwise, click Create an Organization.
  6. Enter an Organization name and click Next.

Install the Edge Delta Agent

Install the Edge Delta agent daemonset in your Kubernetes cluster. This is done by first creating an agent configuration in the Edge Delta web app and then deploying the agent using the customized Helm commands that the web app provides.

After signing up in the web app, the initial set up page opens for deploying an Edge Delta Free Edition agent.

You can also create a new agent configuration manually. Click Admin - Clusters and click Add New Cluster.

  1. Enter a name for the agent tag - usually the same as the name of your cluster and click Continue.
2. Copy the three deploy commands from the web app as they include your agent's secret API key. Run them one at a time in your terminal (the K8s host's shell) to install the Edge Delta agent.

  • The first command downloads the Edge Delta Helm chart.

  • The second command updates all the charts in the local Helm repo.

  • The third command installs the correct version of the agent. It passes in the secret key to connect your agent to the Edge Delta web app, and it creates the edgedelta namespace for the daemonset. The following helm command option shows an example key 123456789 but yours will be specific to your agent.

--set secretApiKey.value=123456
  1. Click I Ran Deploy Commands. The web app checks for an agent hearbeat to confirm that the agent was successfully installed in your cluster and is able to send metrics to the web app.
  2. Click Go to Status Page.

After installing the agent, you can Set Up Alerts.