Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Fleet] added doc how to enable apm on fleet managed agent #182550

Merged
merged 2 commits into from
May 3, 2024
Merged

[Fleet] added doc how to enable apm on fleet managed agent #182550

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0dcf088
added doc how to enable apm on fleet managed agent
juliaElastic May 3, 2024
4bba3cd
added link to cloud conditions
juliaElastic May 3, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions x-pack/plugins/fleet/dev_docs/apm_tracing.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# Enable APM tracing on Fleet managed agent

1. Enroll agent with default config
2. Agent config will be overwritten by the Fleet Agent policy
3. Add APM config to the installed agent config file e.g. on Mac /Library/Elastic/Agent/elastic-agent.yml
```
agent.monitoring:
traces: true
apm:
hosts:
- <apm host url>
environment: <apm environment>
secret_token: <secret token>
```
4. Restart agent to pick up the changes (on standalone agent there is hot reload): https://www.elastic.co/guide/en/fleet/current/start-stop-elastic-agent.html
5. APM config should be applied, and traces should be sent to the APM server configured
6. Observe "APM instrumentation enabled" in the agent logs

More info in agent doc: https://github.com/elastic/elastic-agent/blob/main/docs/tracing.md

## Cloud configuration

- ECS uses the same methodology to add APM config on production builds (e.g. BC).
- Cloud logic that adds APM config: https://github.com/elastic/cloud/blob/master/scala-services/runner/src/main/scala/no/found/runner/allocation/stateless/ApmDockerContainer.scala#L434
- APM is not enabled by default on deployments with SNAPSHOT builds, see all conditions here: https://github.com/elastic/cloud/pull/124414

Loading