Skip to content
Open
Show file tree
Hide file tree
Changes from all 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
54 changes: 54 additions & 0 deletions modules/rosa-create-cluster-log-forwarding-ui.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
// Module included in the following assemblies:
//
// * observability/logging/rosa-forwarding-control-plane-logs.adoc
:_mod-docs-content-type: PROCEDURE
[id="rosa-create-cluster-log-forwarding-ui_{context}"]
= Create a {product-title} cluster with log forwarding

[role="_abstract"]
You can set up control plane log forwarding when you create your {product-title} cluster in the {hybrid-console}. As you create your {product-title} cluster, you have the option to forward your control plane logs to an Amazon `S3` bucket, `CloudWatch` log group, or both.

.Procedure

. In the {hybrid-console}, go to *Clusters* -> *Cluster List*, then click the *Create cluster* button.
. On the *Managed services* offerings page, go to the offering, *Red Hat OpenShift Service on AWS (ROSA)*, and click the *Create cluster* button, then select *With web interface*.
. For *Create a ROSA Cluster* -> *Control plane*, select your *ROSA hosted architecture*.
. For *Accounts and roles*, select your *Associated AWS infrastructure account* and *AWS billing account*.
. For the *Cluster settings* -> *Cluster details*, complete the following text boxes:
+
* *Region*
* *Cluster name*
* *Version*
* *Channel*

+
In about 20 minutes after you complete this information, your cluster is ready to install and you can continue to configure it.
. For *Machine pool* -> *Networking* -> *Configuration* -> *CIDR ranges* -> *Cluster roles and policies*, complete all of the required text boxes with the specifications that you want for your cluster.
. On the *Review and create* -> *Review your ROSA cluster* page, verify that the cluster details are correct.
. Optional: If you want to forward your control plane logs to an Amazon `S3` bucket or `CloudWatch` log group, complete the following instructions:
.. On the *Control plane log forwarding (optional)* page, click *Enable Amazon S3*, or *Enable CloudWatch*, or both.
.. If you enable Amazon `S3`, complete the following fields:
+
* *Bucket name*: Give it a unique identifier across all of {AWS}.
* *Bucket prefix*: Give it an optional path to organize your data.
* *Select groups and applications* (optional): When you select a group, the log forwarder collects all of the applications and related services from that group.
.. If you enable `CloudWatch`, complete the following fields:
+
* *Prerequisite*: Verify that you have created an `IAM` role and policy, then click the box stating that you have.
* *Log group name*: Give it a unique identifier.
* *Role ARN*: Give the `IAM` role ARN. For example, `arn:aws:iam::<12-digit-account-id>:role/<role-name>`.
* *Select groups and applications*: When you select a group, the log forwarder collects all the applications and related services from that group.
.. On the *Review and create* -> *Review your ROSA cluster* page, verify that the cluster details are correct.
.. Click the *Create cluster* button.
. If you want to finish completing your cluster with no designated log forwarding destination, click the *Create cluster* button.

.Verification

. In the {hybrid-console}, go to *Clusters* -> *Cluster List*. You can see the name and status of your cluster.
. Verify that the status of your cluster is “Ready” and click the name of your cluster.
. In the *Overview* tab, verify that the details of your cluster are what you specified.
. Go to the *Control plane log forwarding* section.
.. If you enabled `Amazon S3`, verify that you see *Amazon S3: Enabled*. If you did not set it up, it shows, *Amazon S3: Disabled*.
.. If you enabled `CloudWatch`, verify that you see *CloudWatch: Enabled*. If you did not set it up, it shows, *CloudWatch: Disabled*.
. Click *View details*, which takes you to the *Settings* tab. Confirm all the specific details for your control plane log forwarding are correct.

13 changes: 13 additions & 0 deletions modules/rosa-create-cluster-ui-log-groups.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
// Module included in the following assemblies:
//
// * observability/logging/rosa-configuring-the-log-forwarder.adoc
:_mod-docs-content-type: CONCEPT
[id="rosa-create-cluster-ui-log-groups_{context}"]
= Creating a {product-title} cluster in the {hybrid-console}

[role="_abstract"]
You can forward logs from your {product-title} cluster to `CloudWatch`, `S3`, or both. When you forward your control plane logs, you can store them in the infrastructure that you designated, helping you meet compliance and audit requirements and workflows.

In the {hybrid-console}, you set up your {product-title} cluster to forward control plane logs when you create the cluster. Then, you can continue to use the web user interface (UI) to forward your control plane logs.

Enable control plane log forwarding when you create the cluster to ensure a complete audit trail. If enabled later, the feature cannot capture logs generated before the activation, leaving gaps in your data.
30 changes: 30 additions & 0 deletions modules/rosa-edit-cluster-log-forwarding-ui.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
// Module included in the following assemblies:
//
// * observability/logging/rosa-forwarding-control-plane-logs.adoc
:_mod-docs-content-type: PROCEDURE
[id="rosa-edit-cluster-log-forwarding-ui_{context}"]
= Edit a {product-title} cluster with log forwarding

[role="_abstract"]
You can verify the status of log forwarding for a cluster and edit the log forwarding configurations.

.Procedure

. In the {hybrid-console}, go to *Clusters* -> *Cluster List*, then click the name of your cluster.
. Go to the *Settings* tab then the *Control plane log forwarding* section.
. To add to your log forwarding, click the *Add configuration* dropdown button.
.. You can add a `CloudWatch` or `Amazon S3` configuration.
. To make changes to your existing log forwarding, click the three dots within your `CloudWatch` or `Amazon S3` log forwarding configuration, then select *Edit configuration* or *Delete configuration*.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

this is fine, but i could've sworn we had like a three dot vertical image to be used in places like this. i might be misremembering though!

. When you click *Edit configuration* for `Amazon S3` log forwarding, you see your configuration and can make changes to the following:
* *Bucket Name*
* *Bucket Prefix*
* *Select groups and applications*
. When you click *Edit configuration* for `CloudWatch` log forwarding, you see your configuration and can make changes to the following:
* *Log group name*
* *Role ARN*
* *Select groups and applications*
. Make the changes to your configuration, then click *Save*.

.Verification

. In the *Settings* tab -> *Control plane log forwarding* section, verify that you see the changes you made to your configuration. The changes you made instantly go through and appear in this section.
6 changes: 6 additions & 0 deletions observability/logging/rosa-forwarding-control-plane-logs.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -22,3 +22,9 @@ include::modules/rosa-set-up-cloudwatch-log-group.adoc[leveloffset=+1]
include::modules/rosa-set-up-s3-bucket.adoc[leveloffset=+1]

include::modules/rosa-manage-control-plane-log-forwarding.adoc[leveloffset=+1]

include::modules/rosa-create-cluster-ui-log-groups.adoc[leveloffset=+1]

include::modules/rosa-create-cluster-log-forwarding-ui.adoc[leveloffset=+1]

include::modules/rosa-edit-cluster-log-forwarding-ui.adoc[leveloffset=+1]