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:

Manage locally installed agents (metrics, logs, etc.)

Usage:
  circonus-cma [flags]

Flags:
      --apiurl string              [ENV: CAM_API_URL] Circonus API URL (default "https://something.circonus.com")
      --aws-ec2-tags stringArray   [ENV: CAM_AWS_EC2_TAGS] AWS EC2 tags for registration meta data
  -c, --config string              config file (default: /opt/circonus/cma/etc/circonus-cma.yaml|.json|.toml)
  -d, --debug                      [ENV: CAM_DEBUG] Enable debug messages
  -h, --help                       help for circonus-cma
      --inventory                  [ENV: CAM_INVENTORY] Inventory installed collectors
      --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            [ENV: CAM_REGISTER] Registration token
  -V, --version                    Show version and exit

Linux installation

1. Download appropriate package from releases page
2. Install
3. Run sudo /opt/circonus/am/sbin/circonua-am --register=<registration_token>
4. If registration successful, start the agent manager sudo systemctl start 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 /opt/circonus/am/sbin/circonua-am --register=<registration_token>