agent-manager

README

Circonus Agent Manager (circonus-am)

Requires:

• go
• goreleaser
• golangci-lint

1. Build (for testing): goreleaser build --clean --snapshot
2. Release:
   1. Ensure all commits/PRs are merged
   2. Ensure repo is up-to-date
   3. Tag with semver from CHANGELOG.md
   4. Run goreleaser release --clean

Configuration:

Manager for local agents (metrics, logs, etc.)

Usage:
  circonus-am [flags]

Flags:
      --apiurl string              [ENV: CAM_API_URL] Circonus API URL (default "https://web-api.svcs-np.circonus.net/configurations/v1")
      --aws-ec2-tags strings       [ENV: CAM_AWS_EC2_TAGS] AWS EC2 tags for registration meta data
  -c, --config string              config file (default: /opt/circonus/am/etc/circonus-am.yaml|.json|.toml)
  -d, --debug                      [ENV: CAM_DEBUG] Enable debug messages
  -h, --help                       help for circonus-am
      --inventory                  Inventory installed agents and exit
      --log-level string           [ENV: CAM_LOG_LEVEL] Log level [(panic|fatal|error|warn|info|debug|disabled)] (default "info")
      --log-pretty                 Output formatted/colored log lines [ignored on windows]
      --poll-interval string       [ENV: CAM_POLL_INTERVAL] Polling interval for actions (default "60s")
      --register string            Registration token -- register agent manager, inventory installed agents, and exit
      --tags strings               [ENV: CAM_TAGS] Custom key:value tags for registration meta data
  -V, --version                    Show version and exit

Note on tags

• Environment variable format with a space separated list, e.g. CAM_TAGS="foo:bar baz:qux"
• CLI option format with a comma separated list, e.g. --tags="foo:bar,baz:qux"

Linux installation

1. Download appropriate package from releases page
2. Install (use sudo to install, like all packages)
3. Run sudo /opt/circonus/am/sbin/circonua-am --register=<registration_token>
4. If registration successful, restart the agent manager sudo systemctl restart circonus-am
5. Check status of agent manager sudo systemctl status circonus-am
6. If an additional agent is installed AFTER the agent manager has registered
   1. Stop agent manager sudo systemctl stop circonus-am
   2. Run sudo /opt/circonus/am/sbin/circonus-am --inventory
   3. Start agent manager sudo systemctl start circonus-am

Unprivileged

1. Create dedicated user and group (e.g. cam)
2. Change ownership of /opt/circonus/am and all files to the user and group (ensure user can also access /opt and /opt/circonus e.g. 755 or owned by group)
3. Edit the systemd unit to add User and Group stanzas (sysctl edit circonus-am)
4. Restart circonus-am if it is currently running
5. For all agent config files that the manager will manage:
   1. change the group ownership to the group created above
   2. change permissions to allow write by group
6. Add sudo configs for the commands of each installed agent
7. Change agent definitions to include sudo for each of the commands used for managing the agent

Decomission (linux)

1. sudo systemctl stop circonus-am
2. sudo /opt/circonus/am/sbin/circonus-am --decomission
3. Remove package using tool used to install e.g. apt/dpkg or yum/rpm