Skip to content

Conversation

@pleimer
Copy link
Contributor

@pleimer pleimer commented Jun 4, 2021

I propose we delete the section in the docs describing each individual panel within the infrastructure dashboard and replace it with a short description of the dashboard in the introduction. Additionally, add a description of the cloud view dashboard in the introduction since we support it.

The section is hardly useful because it is way out of date and not reflective of the current state of the dashboard. Additionally, providing explanations of what each metric is is not really our responsibility; an admin should view the collectd or kernel docs to find more information. Anyone who gets as far as deploying the dashboards should have a pretty good understanding of what each metric is measuring anyway. Besides, there are short descriptions of each panel in the info section in the dashboards.

pleimer and others added 3 commits June 7, 2021 11:23
Co-authored-by: JoanneOFlynn2018 <45287002+JoanneOFlynn2018@users.noreply.github.com>
Removed link to deleted reference file.
@JoanneOFlynn2018 JoanneOFlynn2018 merged commit c81cf2c into master Jun 8, 2021
@JoanneOFlynn2018 JoanneOFlynn2018 deleted the cleanup-dashboard-docs branch June 8, 2021 09:20
JoanneOFlynn2018 added a commit that referenced this pull request Jun 8, 2021
)

* replace dashboard section with shorter description in introduction

* Update doc-Service-Telemetry-Framework/modules/con_dashboards.adoc

Co-authored-by: JoanneOFlynn2018 <45287002+JoanneOFlynn2018@users.noreply.github.com>

* better wording

* Inserted cross references. (#200)

Removed link to deleted reference file.

Co-authored-by: JoanneOFlynn2018 <45287002+JoanneOFlynn2018@users.noreply.github.com>
JoanneOFlynn2018 added a commit that referenced this pull request Jun 8, 2021
) (#201)

* replace dashboard section with shorter description in introduction

* Update doc-Service-Telemetry-Framework/modules/con_dashboards.adoc

Co-authored-by: JoanneOFlynn2018 <45287002+JoanneOFlynn2018@users.noreply.github.com>

* better wording

* Inserted cross references. (#200)

Removed link to deleted reference file.

Co-authored-by: JoanneOFlynn2018 <45287002+JoanneOFlynn2018@users.noreply.github.com>

Co-authored-by: pleimer <41337120+pleimer@users.noreply.github.com>
@leifmadsen leifmadsen mentioned this pull request Jun 17, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

3 participants