Skip to main content

Install the agents

Follow the How to install panel the Portal shows after provisioning. It matches the option you chose.

Kubernetes cluster​

  1. Run the downloaded install script with kubectl and helm pointed at your single-node cluster. It installs a Controller and a Gocipher.
  2. Wait 1 to 2 minutes so Spider can capture the network usage of your cluster.

There is no whisperer to install: the Controller injects it when you attach.

Docker or plain binaries​

  1. Edit toWatch.json. It tells Gocipher which process to decrypt. It ships with a placeholder target, and until you change it Gocipher decrypts nothing and does not tell you (it only logs a warning every 10 seconds).

    Valid targets are exactly:

    TargetMeaning
    pid://<number>One running process
    file://<path>An executable or a libssl.so path
    docker://<id>Every process of a Docker container
    containerd://<id>Every process of a containerd container

    There is no wildcard and no "watch everything".

  2. Both agents read their configuration from the CONFIG environment variable, or from a file named config.json in their working directory. The downloaded files are named whisperer-config.json and gocipher-config.json: pass them to the Docker commands as shown, or rename each to config.json for the plain binaries.

  3. Run the Whisperer and Gocipher with the commands the Portal shows. Gocipher runs --privileged in Docker.


Next, capture and look.