Extending with custom manual instrumentation

[zeitlinger]

Fixes #5713

[svrnm]

thanks

[zeitlinger]

@svrnm can you check?

[svrnm]

One more thing, I am not sure if api is the right name for that, since we do not even mention "api" in the title, description, so either we do that, e.g. "Adding custom instrumentations with the API" or we rename the file to something like "extending-instrumentation.md" as well. wdyt?

[zeitlinger]

One more thing, I am not sure if api is the right name for that, since we do not even mention "api" in the title, description, so either we do that, e.g. "Adding custom instrumentations with the API" or we rename the file to something like "extending-instrumentation.md" as well. wdyt?

it's API to separate it from annotations - which also extend

[zeitlinger]

@svrnm please check again

[svrnm]

the title is now longer then the description, here is a proposal

Suggested change

	---
	title: Extending with custom manual instrumentation using the OpenTelemetry API
	linkTitle: Extending instrumentation
	description: Extending a Java agent with custom manual instrumentation.
	weight: 21
	---
	---
	title: Extending instrumentations with the API
	linkTitle: Extend with the API
	description: Use the OpenTelemetry API in combination with the Java agent to extend the automatically generated telemetry with custom instrumentations
	weight: 21
	---

@chalin @jack-berg can you take a look as well?

[chalin]

Your proposal LGTM.

[zeitlinger]

I adjusted slightly:

Use the OpenTelemetry API in combination with the Java agent to extend the automatically generated telemetry with custom spans and metrics