No description, website, or topics provided.
Shell HTML
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.final_builds
config
jobs/boshhmforwarder
manifests
packages Bump golang version Feb 7, 2018
releases/bosh-hm-forwarder
scripts
src
.envrc
.gitignore
.gitmodules
LICENSE
NOTICE
README.md

README.md

Bosh HM Forwarder Release slack.cloudfoundry.org

Bosh HM Forwarder is a companion job to metron_agent that sends bosh health metrics through loggregator.

Usage

bosh_hm_forwarder is to be colocated with a metron_agent. It reads metrics from the host VM and forwards them (via UDP) to the metron_agent.

Deployment

Changes to Bosh Deployment

These instructions are colocating the job with metron_agent.

  1. Add the release to your deployment manifest.

    releases:
    +  - name: bosh-hm-forwarder
    +    version: latest
       - name: loggregator
         version: latest

    Then bosh upload release the latest bosh-hm-forwarder-release.

  2. Colocate the job that has metron_agent.

    jobs:
      - name: some_job_z1
      templates:
      - name: metron_agent
        release: loggegator
    + - name: boshhmforwarder
    +   release: bosh-hm-forwarder
      instances: 1
      resource_pool: default
      networks:
        - name: default
      properties:
      # standard metron properties...

    Then bosh deploy this updated manifest.

  3. Validate the metrics can be seen.

    Assuming you are using bosh-hm-forwarder-release with CF Release, you can use the CF Nozzle plugin

    cf nozzle -filter ValueMetric | grep "system.cpu.user"

Enable Bosh Director with OpenTSDB Plugin

The bosh director needs to be updated to enable the OpenTSDB health monitor.

Example manifest

The example manifest provided in manifests/ requires that the vars generated from loggregator are passed in.

For example:

bosh -d boshhmforwarder -e <env> deploy manifests/boshhmforwarder.yml --vars-file ./loggregator-vars.yml