Skip to content

Commit 81b6211

Browse files
committed
pr suggestions grammer and spelling
Signed-off-by: R-Lawton <rlawton@redhat.com>
1 parent a683a56 commit 81b6211

1 file changed

Lines changed: 7 additions & 7 deletions

File tree

rfcs/0000-observability-api.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ This is a proposal for adding the ability to configure aspects of observability
1313
# Motivation
1414
[motivation]: #motivation
1515

16-
Users of Kuadrant (Platform engineers and or Site reliability engineers) will want a way to be able to configure different aspects of observability for Kuadrant without having to configure things at the component level themselves. Providing users this ability allows them to not have to have a deep knowledge of the inner workings of the components as well as integrate Kuadrant observability pieces with their own observability stack or Openshift user workload monitoring. Resulting in a fully comprehensive observability view all configured in one location.
16+
Users of Kuadrant (Platform engineers and or Site reliability engineers) will want a way to be able to configure different aspects of observability for Kuadrant without having to configure things at the component level themselves. Providing users this ability allows them to integrate Kuadrant observability pieces with their own observability stack or Openshift user workload monitoring without needing a deep knowledge of the inner workings of the components, resulting in a fully comprehensive observability view all configured in one location.
1717

1818
# Guide-level explanation
1919
[guide-level-explanation]: #guide-level-explanation
@@ -59,7 +59,7 @@ spec:
5959
```
6060
6161
### Status
62-
The status of the Kuadrant CR will not be the observability stack is in a "healthy" state i.e Prometheus and Grafana is up and running. It should be the status of only the things that we have control over. The status will show what components the user will have configured for example logging setup for Authorino and Limitador. We will not be taking responsibility for aspects we don't have control over.
62+
The status of the Kuadrant CR will not be whether the observability stack is in a "healthy" state, i.e., Prometheus and Grafana is up and running. It should be the status of only the things that we have control over. The status will show what components the user has configured, for example, the logging setup for Authorino and Limitador. We will not be taking responsibility for aspects we don't have control over.
6363
6464
#### Example status:
6565
@@ -80,11 +80,11 @@ metrics:
8080
8181
In terms of how the information supplied in the Kuadrant CR will get passed to the other Kuadrant components, multiple options have been brought up:
8282
83-
- directly - like setting flags or configuration directly on the deployments of the different Kuadrant components.
84-
- indirectly - Passing the information to Authorino & Limitador via the Authorino & Limitador CRs
85-
- indirectly - Passing the information to Authorino & Limitador in the form of there own Observability CRs
83+
1. directly - like setting flags or configuration directly on the deployments of the different Kuadrant components.
84+
2. indirectly - Passing the information to Authorino & Limitador via the Authorino & Limitador CRs
85+
3. indirectly - Passing the information to Authorino & Limitador in the form of their own Observability CRs
8686
87-
The best approach would be the indirect approach, meaning once the Kuadrant CR is updated, the information is passed to the relevant component CR. For example the tracing section in the Authorino CR spec would be updated with the required endpoints and other configuration from the Kuadrant CR. This does mean that the spec exposed is whats in the Kuadrant component CR's but new changes can be requested and implemented in said components.
87+
The best approach would be the approach 2), an indirect approach, meaning once the Kuadrant CR is updated, the information is passed to the relevant component CR. For example the tracing section in the Authorino CR spec would be updated with the required endpoints and other configuration from the Kuadrant CR. This does mean that the spec exposed is whats in the Kuadrant component CR's, but new changes can be requested and implemented in said components.
8888
8989
#### Adding, modifying and deleting values or no values
9090
@@ -131,7 +131,7 @@ An other option that has been investigated which is very similar to above, is ha
131131
132132
The reason why we should not go with the above method is reliance. The Observability CR will rely on the Kuadrant CR being present and we moving away from that model. From a user point of view having a users have to change configuration in 3+ separate crs in some cases, is tedious and slow.
133133
134-
If we don't decide to any of these options the user will have to manually in multiple places add there configuration of their desired observability stack which can result in poor user experience, mistakes being made and values not being tracked properly.
134+
If we don't decide to go with any of these options, the user will have to manually add the configuration of their desired observability stack in multiple places, which can result in poor user experience, mistakes being made and values not being tracked properly.
135135
136136
137137
# Prior art

0 commit comments

Comments
 (0)