This repository is a blueprint to show how the Instana agent installation and configuration can be automated with Chef and is intended for others to fork and build upon. It is not actively maintained. If you have introduce new functionality on your fork that you think is useful for others, get in touch so we can link to it from here.
instana-agent Cookbook
This Chef cookbook installs, configures and runs the monitoring agent for the Instana monitoring suite.
Flavors
instana-agent-dynamic
This blank agent comes bundled with a JDK and is configured to download all neccessary sensors when it starts. Additionally, it is configured to update its set of sensors on a daily basis.
instana-agent-static
This "gated" agent package is supposed to not connect to the internet at all. It comes with all the recent sensors and a JDK, and is your package of choice when you run a tight firewall setup.
Monitoring endpoint
If you're an onprem customer, please specify your hostname and port in the corresponding attributes. If you're using our SaaS offering, and don't know which endpoint the agent should send to, feel free to ask our sales team.
Supported operating systems
See our official documentation.
Attributes
- See attributes file.
License and Authors
Some attributes may be loaded via a chef databag: instana-agent, item: general
Example:
{
"id": "general",
"flavor": "static",
"key": "your_agent_key",
"endpoint_host": "saas-us-west-2.instana.io",
"endpoint_port": 443,
"mode": "apm",
"zone": "production",
"tags": ["tag", "another"]
}
This cookbook is being submitted and maintained under the Apache v2.0 License.
Publish to Chef Supermarket
- Update the version number in the module’s metadata.rb file
- Update CHANGELOG.md
- Push changes to the module repository
- Trigger Jenkins Job
Copyright 2017, INSTANA Inc.