Skip to content

Troubleshooting Harvest

Chris Grindstaff edited this page May 20, 2021 · 28 revisions

Checklists for Harvest

A set of steps to go through when something goes wrong.

Install fails

I tried to install and ...

How do I tell if Harvest is doing anything?

You believe Harvest is installed fine, but it's not working.

  • Post the contents of your harvest.yml

Try validating your harvest.yml with yamllint like so: yamllint -d relaxed harvest.yml If you do not have yamllint installed, look here.

There should be no errors - warnings like the following are fine:

harvest.yml
  64:1      warning  too many blank lines (3 > 0)  (empty-lines)
  • How did you start Harvest?

  • What do you see in /var/log/harvest/*

  • What does ps aux | grep poller show?

  • If you are using Prometheus, try hitting Harvest's Prometheus endpoint like so:

curl http://machine-this-is-running-harvest:prometheus-port-in-harvest-yaml/metrics

How do I start Harvest in debug mode?

harvest start --foreground

If your harvest.yml file contains more than one poller, you will need to comment out all but one.

Errors in the log file

Clone this wiki locally