Ingest tutorial review: Monitor a Java application

[colleenmcginnis]

This sprint, start getting more familiar with new ingest-related concepts by running through an existing tutorial: Monitor a Java application.

To do

• Follow the steps in the tutorial.
• Identify parts that are confusing, outdated, or incorrect.
• Make any necessary updates that you're able to do, for example:
  • Improve prose, fix typos, update links, etc.
  • Fix broken workflows and incorrect information.
  • Update screenshots.
• For any problems you're not sure how to fix you can:
  • Ask for help in #the-ski-team and/or the relevant dev channel.
  • Open a new issue and ask for help finding someone with the answers.

Related issues

Existing issues related to this tutorial in case they are helpful:

• [Website]: Create or update Java tutorial to use Elastic Agent #1479
• Update tutorial about monitoring Java app to show Elastic Agent #1881
• Tutorial Monitor a Java Application - Feedback on some problems encountered #1836

Note: You don't have to close out all existing issues, but you can if you address the concerns in the issue!

[karenzone]

Initial review notes

General guidelines

Who's the target audience?
What are the learning objective(s)?
What will you need to have installed? Or have access to install or reference as part of the tutorial?

Notes and observations

Add "we expect you to know" section or "your chances of success increase if you come in knowing these things"
Metricbeat Prometheus Module —> Prometheus Integration
Replace MB module as soon as possible.
The "Prefer to use Elastic Agent?" messaging is outdated. WE want people–espeically new users–to use Agent/Integrations, and certainly not start fresh with Beats when there's a better alternative.
Needs Process overview (similar to "What you'll learn")
General: Provide more context!!!
Thoughts on headings with embedded numbers.
Can docs-builder help with that???
Add comprehensive "You will need…" section near the top

Before you begin

Replace "Before you begin" with "Prerequisites"
"Create an Elastic Cloud Hosted deployment."
Should this be an "Elastic for Observability" project??? The choice is on the page after you click "Create hosted deployment."
So maybe it's changes to two pages instead of one now that we have the Hosted/Serverless decision on the landing page?
"Create hosted deployment" instruction still works because the button is clearly visible and in contrast to "Create serverless project" button.
"If you do not want to follow all those steps listed here and take a look at the final java code, check out the observability-contrib GitHub repository for the sample application."
What does this mean?
"... all those steps…" ???
What am I looking at when I go to the GitHub repo?
ToDo: Provide more context!!

Step 1: Create a Java application

More requirements (add tips for finding/getting these)
OpenJDK 14 or higher
Javalin web framework
Gradle???
Others???

Step 2: Ingest logs

More requirements???
log4j2?
"Within the lambda???" Should this be "lambda function?"