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.

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

Trouble shooting section for Percona Everest #157

Draft
wants to merge 84 commits into
base: main
Choose a base branch
from

Conversation

rasika-chivate
Copy link
Collaborator

Add a trouble shooting section for Percona Everest

Copy link

render bot commented Aug 20, 2024

@rasika-chivate rasika-chivate temporarily deployed to trouble_shooting+everest - Everest Release Branch PR #157 November 25, 2024 08:03 — with Render Destroyed
docs/index.md Outdated Show resolved Hide resolved
docs/reference/troubleshoot.md Outdated Show resolved Hide resolved
docs/reference/troubleshoot.md Show resolved Hide resolved
Comment on lines +58 to +59
- Everest
- VictoriaMetrics
Copy link
Collaborator

Choose a reason for hiding this comment

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

Mayank is working on a change right now that will remove the Everest and VM operators from OLM. Since we are working on this right now we might as well prepare for the 1.4 release and remove them from this OLM section.

We should still mention somewhere that we install the everest operator in the everest-system namespace and the VM operator in the everest-monitoring namespace.

docs/reference/troubleshoot.md Outdated Show resolved Hide resolved
docs/reference/faq.md Outdated Show resolved Hide resolved
**Answer:**
The logs will be accessible in the console of the web browser.

### Are there any additional resources that are not included in the image?
Copy link
Collaborator

Choose a reason for hiding this comment

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

I don't find this title very descriptive. It seems to me that the questions you ask below are unrelated with this 🤔

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

@recharte Rephrased it:

Is there a resource that manages the API calls and interacts with the individual resources?

  • Should we check the logs for troubleshooting when issues arise? Alternatively, does the Everest API communicate directly with the Everest operator resources?

  • If so, should we correlate the Percona operator issue with the corresponding Everest resource and address the problem from that point?

docs/reference/faq.md Outdated Show resolved Hide resolved
While `MonitorConfig` is present, does this resource interact directly with each `ppm-agent` container on the database pods, deploy new PMM Servers, and modify their configuration?

**Answer:**
When communicating with PMM, we generate an API key to facilitate data transmission. This API key allows us to configure monitoring endpoints for individual database operators, enabling them to send data to PMM.
Copy link
Collaborator

Choose a reason for hiding this comment

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

I feel that you asked an important the correct question (deploy new PMM Servers, and modify their configuration?) but don't answer it properly.
I think we should explicitly mention that everest doesn't deploy PMM. Instead, we configure PMM agents in each DB deployment to communicate with an existing PMM server.

The API is responsible for updating Everest resources, while the Everest operator continues to create resources for the corresponding database operators. When debugging, start with the API, then proceed to the Everest operator, and finally examine the individual database operators.


### Why PMM appears to be absent in this context?
Copy link
Collaborator

Choose a reason for hiding this comment

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

I don't find this title very descriptive 🤔

@it-percona it-percona temporarily deployed to trouble_shooting+everest - everest-doc PR #157 November 25, 2024 11:51 — with Render Destroyed
Co-authored-by: Diogo Recharte <[email protected]>
@rasika-chivate rasika-chivate temporarily deployed to trouble_shooting+everest - Everest Release Branch PR #157 November 25, 2024 11:51 — with Render Destroyed
@it-percona it-percona temporarily deployed to trouble_shooting+everest - everest-doc PR #157 November 25, 2024 11:51 — with Render Destroyed
@rasika-chivate rasika-chivate temporarily deployed to trouble_shooting+everest - Everest Release Branch PR #157 November 25, 2024 11:51 — with Render Destroyed
Co-authored-by: Diogo Recharte <[email protected]>
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.

3 participants