Skip to content

Deprecate old HTTP wrapping methods and add instructions for installing dd-trace-java. #31

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.

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

Merged
merged 8 commits into from
Feb 24, 2021

Conversation

agocs
Copy link
Contributor

@agocs agocs commented Feb 19, 2021

What does this PR do?

Adds installation instructions for the Java tracer. Marks some functions deprecated that the tracer does better.

Motivation

Testing Guidelines

Additional Notes

Types of changes

  • Bug fix
  • New feature
  • Breaking change
  • Misc (docs, refactoring, dependency upgrade, etc.)

Checklist

  • This PR's description is comprehensive
  • This PR contains breaking changes that are documented in the description
  • This PR introduces new APIs or parameters that are documented and unlikely to change in the foreseeable future
  • This PR impacts documentation, and it has been updated (or a ticket has been logged)
  • This PR's changes are covered by the automated tests
  • This PR collects user input/sensitive content into Datadog

@agocs agocs requested a review from a team as a code owner February 19, 2021 15:09
@agocs agocs changed the title Deprecate old HTTP wrapping methods and start on trace/log correlatio… Deprecate old HTTP wrapping methods and add instructions for installing dd-trace-java. Feb 19, 2021
README.md Outdated
Don't see your favorite client? Open an issue and request it. Datadog is adding to
this library all the time.
The Java Tracer adds a nontrivial cold start penalty.
Expect roughly 6 seconds per cold start if your lambda function is configured with 3008MB of memory.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: lambda -> Lambda

README.md Outdated

### HttpUrlConnection examples
### Compatable Java runtimes
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Compatable -> Compatible

README.md Outdated
by cloning the existing Lambda Pipeline. The new parser can extract the trace context from the correct position in the logs.
Use the helper `_trace_context` to extract the trace context. For example, if your log line looked like:
The dd-trace-java tracer will automatically add trace context to outgoing requests for a number of popular services.
The list of instrument services can be found here: https://docs.datadoghq.com/tracing/setup_overview/compatibility_requirements/java/ .
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

instrument -> instrumented

to any log message.
```
java_tracer %{date("yyyy-MM-dd HH:mm:ss"):timestamp}\s\<%{uuid:lambda.request_id}\>\s%{word:level}\s+%{data:call_site}%{_trace_context}%{data:message}
```
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this parser the same one we provide out of the box with the default Lambda log pipeline? If that is the case, shouldn't this just work without the customer having to know about the parser? If that is not the case, is there a reason we can't format the logs in the format already understood by the default parser?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't have the power (as far as I know) to change how the customer formats their logs. We can just suggest formats. I think the smart thing to do is to bias towards action, get this out there, and see how customers use it.

Copy link
Contributor

@nhinsch nhinsch left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me, just did a proofreading pass, also one question about the logs parser.

@agocs agocs merged commit f2bf3ca into main Feb 24, 2021
@agocs agocs deleted the chris.agocs/revise_docs_for_tracer_release branch February 24, 2021 16:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants