docs(logger): document enriching logs with logrecord attributes

[kbakk]

Issue number: #1267

Summary

Document how users of the Logger can further enrich logs

Changes

Add additional FAQ question/answer.

User experience

n/a

Checklist

If your change doesn't seem to apply, please leave them unchecked.

• Meet tenets criteria
• I have performed a self-review of my this change
• Changes are tested
• Changes are documented
• PR title follows conventional commit semantics

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

---

View rendered docs/core/logger.md

[boring-cyborg]

Thanks a lot for your first contribution! Please check out our contributing guidelines and don't hesitate to ask whatever you need.

[heitorlessa]

These look great!! One minor change to stay on brand with Powertools in capital, and one paragraph suggestion to ease reading.

[kbakk]

Did you want me to fix this as well in this PR?

https://github.com/awslabs/aws-lambda-powertools-python/blob/94de4945b676173d1eacb87d57e9e65adb0aab2c/examples/logger/src/cloning_logger_config.py#L8

(change to logging.getLogger())

I went with powertools because adjacent section used that:

https://github.com/awslabs/aws-lambda-powertools-python/blob/7505fcb0c38a9b74561606c72ad5352e6cd33e65/docs/core/logger.md#L597

Want me to fix that too here? 🙂

[kbakk]

Ah, and one more thing, would you like a commit with changing **Headings like this** to #### Headings like this (so we can link to the FAQ questions)?

[heitorlessa]

Yes to all of them!!!! Thank you

[kbakk]

FAQ now has headers and links. 🙂

[kbakk]

Nit, but.... "Powertools Logger" instead of `Powertools Logger"?

Suggested change

	The Python standard library log records contains a [large set of atttributes](https://docs.python.org/3/library/logging.html#logrecord-attributes){target="_blank"}, however only a few are included in Powertools Logger log record by default.
	The Python standard library log records contains a [large set of atttributes](https://docs.python.org/3/library/logging.html#logrecord-attributes){target="_blank"}, however only a few are included in Powertools `Logger` log record by default.

[heitorlessa]

I see why it'd make sense, but it'd be difficult to stay consistent over time - let's keep Powertools Logger. At least until we explore tools like Vale.

[kbakk]

Sounds good. I think this is ready to merge then.

[heitorlessa]

For example, here Logger is more explicit in intent than Logger.

[heitorlessa]

Merging. Thank you so much again @kbakk. This will help a ton of customers coming from standard logging lib

[boring-cyborg]

Awesome work, congrats on your first merged pull request and thank you for helping improve everyone's experience!