diff --git a/docs/CustomizingAzdParameters.md b/docs/CustomizingAzdParameters.md index 2de3d2923..770c50e8f 100644 --- a/docs/CustomizingAzdParameters.md +++ b/docs/CustomizingAzdParameters.md @@ -22,6 +22,7 @@ By default this template will use the environment name as the prefix to prevent | `AZURE_ENV_LOG_ANALYTICS_WORKSPACE_ID` | string | `` | Reuses an existing Log Analytics Workspace instead of provisioning a new one. | | `AZURE_EXISTING_AI_PROJECT_RESOURCE_ID` | string | `` | Reuses an existing AI Foundry Project Resource Id instead of provisioning a new one. | + ## How to Set a Parameter To customize any of the above values, run the following command **before** `azd up`: diff --git a/docs/DeploymentGuide.md b/docs/DeploymentGuide.md index fd00a54c5..7d54bbc54 100644 --- a/docs/DeploymentGuide.md +++ b/docs/DeploymentGuide.md @@ -137,6 +137,14 @@ To adjust quota settings, follow these [steps](./AzureGPTQuotaSettings.md). +
+ + Reusing an Existing Log Analytics Workspace + + Guide to get your [Existing Workspace ID](/docs/re-use-log-analytics.md) + +
+ ### Deploying with AZD Once you've opened the project in [Codespaces](#github-codespaces), [Dev Containers](#vs-code-dev-containers), or [locally](#local-environment), you can deploy it to Azure by following these steps: diff --git a/docs/images/re_use_log/logAnalytics.png b/docs/images/re_use_log/logAnalytics.png new file mode 100644 index 000000000..95402f8d1 Binary files /dev/null and b/docs/images/re_use_log/logAnalytics.png differ diff --git a/docs/images/re_use_log/logAnalyticsJson.png b/docs/images/re_use_log/logAnalyticsJson.png new file mode 100644 index 000000000..3a4093bf4 Binary files /dev/null and b/docs/images/re_use_log/logAnalyticsJson.png differ diff --git a/docs/images/re_use_log/logAnalyticsList.png b/docs/images/re_use_log/logAnalyticsList.png new file mode 100644 index 000000000..6dcf4640b Binary files /dev/null and b/docs/images/re_use_log/logAnalyticsList.png differ diff --git a/docs/re-use-log-analytics.md b/docs/re-use-log-analytics.md new file mode 100644 index 000000000..d59a92660 --- /dev/null +++ b/docs/re-use-log-analytics.md @@ -0,0 +1,31 @@ +[← Back to *DEPLOYMENT* guide](https://github.com/microsoft/Build-your-own-copilot-Solution-Accelerator/blob/psl-re-use-log-update-CA/docs/DeploymentGuide.md#deployment-options--steps) + +# Reusing an Existing Log Analytics Workspace +To configure your environment to use an existing Log Analytics Workspace, follow these steps: +--- +### 1. Go to Azure Portal +Go to https://portal.azure.com + +### 2. Search for Log Analytics +In the search bar at the top, type "Log Analytics workspaces" and click on it and click on the workspace you want to use. + +![alt text](../docs/images/re_use_log/logAnalyticsList.png) + +### 3. Copy Resource ID +In the Overview pane, Click on JSON View + +![alt text](../docs/images/re_use_log/logAnalytics.png) + +Copy Resource ID that is your Workspace ID + +![alt text](../docs/images/re_use_log/logAnalyticsJson.png) + +### 4. Set the Workspace ID in Your Environment +Run the following command in your terminal +```bash +azd env set AZURE_ENV_LOG_ANALYTICS_WORKSPACE_ID '' +``` +Replace `` with the value obtained from Step 3. + +### 5. Continue Deployment +Proceed with the next steps in the [deployment guide](https://github.com/microsoft/Build-your-own-copilot-Solution-Accelerator/blob/psl-re-use-log-update-CA/docs/DeploymentGuide.md#deployment-options--steps).