From f9a63fa1d08990b5cc90ab2cb9ecd1edd6a87aa0 Mon Sep 17 00:00:00 2001 From: Mesh44 Date: Fri, 20 Sep 2024 20:15:47 +0100 Subject: [PATCH] Ms oci o11y solutions branch (#57) * Added Directory grafana-on-oci * Added Directory Dashboards * Added dashboard json files * content2 * TEST change * test remove * M1 * spaces --- knowlege-content/.vscode/settings.json | 5 ++++ knowlege-content/grafana-on-oci/README.md | 29 ++++++++++------------- 2 files changed, 18 insertions(+), 16 deletions(-) create mode 100644 knowlege-content/.vscode/settings.json diff --git a/knowlege-content/.vscode/settings.json b/knowlege-content/.vscode/settings.json new file mode 100644 index 0000000..30e8d95 --- /dev/null +++ b/knowlege-content/.vscode/settings.json @@ -0,0 +1,5 @@ +{ + "cSpell.words": [ + "datasource" + ] +} \ No newline at end of file diff --git a/knowlege-content/grafana-on-oci/README.md b/knowlege-content/grafana-on-oci/README.md index 6adc064..d6140ef 100644 --- a/knowlege-content/grafana-on-oci/README.md +++ b/knowlege-content/grafana-on-oci/README.md @@ -37,7 +37,7 @@ Gather the following information before deployment: - Dynamic group name - Policy name -### Step 2: Using and Configuring the Marketplace image +### Step 2: Using and Configuring the Grafana Marketplace image 1. Log in to OCI Console 2. Navigate to Marketplace > All Applications @@ -46,25 +46,25 @@ Gather the following information before deployment: 5. Fill in the required variables as prompted: - General Configuration: - - Compartment Name - - Availability Domain - - Virtual Cloud Network - - Subnet + - Select your Compartment Name + - Select your Availability Domain + - Select your Virtual Cloud Network + - Select your Public Subnet ![General config](Images/RM-GenConfig.jpg) - Instance Configuration: - - Hostname + - Create a Hostname of your choice. (Maximum length of 15 alphanumeric characters. Hyphens and underscores are not allowed.) - Linux Image (Oracle-Linux-8.9-2024.05.29-0 recommended and tested) - Linux Instance Shape (Choose from list, to suite your monitoring requirements). Minimum requirements; memory:512MB, CPU:1. - Number of OCPUs (for flexible shapes) - Memory in GBs (for flexible shapes) - Assign Public IP (default: true) - - SSH Public Key + - Past in your SSH Public Key ![Instance Config1](Images/RM-InstanceConfig.jpg) - Policy Name: - - Dynamic Group Name - - Policy Name + - Create a Dynamic Group Name + - Create a Policy Name ![Instance Config2](Images/RM-InstanceSSHkey.jpg) ## Post-Deployment Configuration @@ -84,7 +84,6 @@ Gather the following information before deployment: ### Configuring OCI Monitoring Data Source to add Instance Principle - Next step is to add the OCI datasource and configure the Instance Principle. 1. Navigate to the Menu on the left > Connections > Data Sources @@ -98,26 +97,24 @@ Next step is to add the OCI datasource and configure the Instance Principle. 6. Click on Save & test and verify Success ![Success](Images/GF-ConnectionSuccess.jpg) - Once the Success box has appeared this confirms the oci-metrics-datasource and Instance Principle have been configured. - +Next step is to import the example custom dashboards. ### Adding Custom Dashboards After deployment, you can import custom dashboards in Grafana to visualise your OCI metrics. -All dashboards are located in the Dashboards directory () +All dashboards are located in the Dashboards directory () 1. Click on one of dashboard json files (for example Stack_Monitoring.json) -2. Copy the content the content. +2. Click on "Copy raw content" to copy the json content. ![copyjson](Images/GH-dashboardjson.jpg) -3. On the Grafana install click on Dashboards and New > Import +3. On the Grafana install click on Dashboards from the Main Menu and then New > Import ![Import](Images/GF-Import.jpg) 4. Past the copied content (from step 2) to the section under "Import via dashboard JSON model" and click Load ![LoadImport](Images/GF-LoadImport.jpg) Ensure to choose oci-metrics-datasource as the Default data source. - At this point you have now imported an example Dashboard, follow the instructions in the Dashboard to view your metrics. ## Troubleshooting