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

SA-5031-Docs-0.10.0 #76

Merged
merged 11 commits into from
Dec 6, 2023
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions content/features.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,3 +86,27 @@ With Multi Tenant Operator teams can share a single cluster with multiple teams,
## Native Experience

Multi Tenant Operator provides multi-tenancy with a native Kubernetes experience without introducing additional management layers, plugins, or customized binaries.

## Caching and Database

Explore the seamless integration of a dedicated database to streamline resource management. Now, all resources managed by MTO are efficiently stored in a Postgres database, enhancing the MTO-Console's ability to effortlessly retrieve essential resources for optimal presentation.

The implementation of this feature is facilitated through the Bootstrap controller, simplifying the deployment process. This controller not only establishes the Postgres database but also configures a service for smooth communication and generates a secret containing crucial details for establishing a secure connection to the database.

Furthermore, the introduction of a dedicated cache layer ensures that there is no added burden on the kube API server when responding to MTO-console requests. This enhancement not only improves response times but also contributes to a more efficient and responsive resource management system.

## Custom Metrics Support

Multi Tenant Operator now supports custom metrics for templates, template instances and template group instances.

Exposed metrics contain, number of resources deployed, number of resources failed, total number of resources deployed for template instances and template group instances. These metrics can be used to monitor the usage of templates and template instances in the cluster.

Additionally, this allows us to expose other performance metrics listed [here](https://book.kubebuilder.io/reference/metrics-reference.html).

More details on [Enabling Custom Metrics](./reference-guides/custom-metrics.md)

## Graph Visualization for Tenants

Multi Tenant Operator now supports graph visualization for tenants on the MTO-Console. Effortlessly associate tenants with their respective resources using the enhanced graph feature on the MTO console. This dynamic graph illustrates the relationships between tenants and the resources they create, encompassing both MTO's proprietary resources and native Kubernetes/OpenShift elements.

More details on [Graph Visualization](./reference-guides/graph-visualization.md)
Binary file added content/images/graph-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added content/images/graph-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added content/images/graph-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
11 changes: 11 additions & 0 deletions content/reference-guides/custom-metrics.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# Custom Metrics Support

Multi Tenant Operator now supports custom metrics for templates, template instances and template group instances. This feature allows users to monitor the usage of templates and template instances in their cluster.

To enable custom metrics and view them in your OpenShift cluster, you need to follow the steps below:

- Ensure that cluster monitoring is enabled in your cluster. You can check this by going to `Observe` -> `Metrics` in the OpenShift console.
- Navigate to `Administration` -> `Namespaces` in the OpenShift console. Select the namespace where you have installed Multi Tenant Operator.
- Add the following label to the namespace: `openshift.io/cluster-monitoring=true`. This will enable cluster monitoring for the namespace.
- To ensure that the metrics are being scraped for the namespace, navigate to `Observe` -> `Targets` in the OpenShift console. You should see the namespace in the list of targets.
- To view the custom metrics, navigate to `Observe` -> `Metrics` in the OpenShift console. You should see the custom metrics for templates, template instances and template group instances in the list of metrics.
30 changes: 30 additions & 0 deletions content/reference-guides/graph-visualization.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Graph Visualization on MTO Console

Effortlessly associate tenants with their respective resources using the enhanced graph feature on the MTO console front end. This dynamic graph illustrates the relationships between tenants and the resources they create, encompassing both MTO's proprietary resources and native Kubernetes/OpenShift elements.

Example Graph:

```mermaid
graph LR;
A(alpha)-->B(dev);
A-->C(prod);
B-->D(limitrange);
B-->E(owner-rolebinding);
B-->F(editor-rolebinding);
B-->G(viewer-rolebinding);
C-->H(limitrange);
C-->I(owner-rolebinding);
C-->J(editor-rolebinding);
C-->K(viewer-rolebinding);
```

Explore your multi-tenant architecture with an intuitive graph that showcases the relationships between tenants and their resources. The MTO console's graph feature simplifies the understanding of complex structures, providing you with a visual representation of your system's organization. Uncover and manage your resources effortlessly with MTO's enhanced graph visualization.

To view the graph of your tenant, follow the steps below:

- Navigate to `Tenants` page on the MTO console using the left navigation bar.
![Tenants](../images/graph-1.png)
- Click on `View` of the tenant for which you want to view the graph.
![Tenant View](../images/graph-2.png)
- Click on `Graph` tab on the tenant details page.
![Tenant Graph](../images/graph-3.png)