Skip to content
Merged
Show file tree
Hide file tree
Changes from 7 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
2 changes: 1 addition & 1 deletion docs/CustomizingAzdParameters.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ By default this template will use the environment name as the prefix to prevent
| `AZURE_ENV_IMAGETAG` | string | `latest` | Set the image tag (allowed values: `latest`, `dev`, `hotfix`). |
| `AZURE_ENV_OPENAI_LOCATION` | string | `eastus2` | Location of the Azure OpenAI resource. Choose from (allowed values: `swedencentral`, `australiaeast`). |
| `AZURE_LOCATION` | string | `japaneast` | Sets the Azure region for resource deployment. |
| `AZURE_ENV_LOG_ANALYTICS_WORKSPACE_ID` | string | `<Existing Workspace Id>` | Reuses an existing Log Analytics Workspace instead of provisioning a new one. |
| `AZURE_ENV_LOG_ANALYTICS_WORKSPACE_ID` | string | Guide to get your [Existing Workspace ID](/docs/re-use-log-analytics.md) | Reuses an existing Log Analytics Workspace 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`:
Expand Down
8 changes: 8 additions & 0 deletions docs/DeploymentGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -137,6 +137,14 @@ To adjust quota settings, follow these [steps](./AzureGPTQuotaSettings.md).

</details>

<details>

<summary><b>Reusing an Existing Log Analytics Workspace</b></summary>

Guide to get your [Existing Workspace ID](/docs/re-use-log-analytics.md)

</details>

### 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:
Expand Down
Binary file added docs/images/re_use_log/logAnalytics.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 docs/images/re_use_log/logAnalyticsJson.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 docs/images/re_use_log/logAnalyticsList.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
31 changes: 31 additions & 0 deletions docs/re-use-log-analytics.md
Original file line number Diff line number Diff line change
@@ -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)
Comment on lines +12 to +21
Copy link

Copilot AI Jun 25, 2025

Choose a reason for hiding this comment

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

The alt text is generic; consider using a more descriptive alt text that conveys the content of the image for better accessibility.

Suggested change
![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)
![List of Log Analytics workspaces in Azure Portal](../docs/images/re_use_log/logAnalyticsList.png)
### 3. Copy Resource ID
In the Overview pane, Click on JSON View
![Overview pane of a Log Analytics workspace showing JSON View](../docs/images/re_use_log/logAnalytics.png)
Copy Resource ID that is your Workspace ID
![JSON View of a Log Analytics workspace showing the Resource ID](../docs/images/re_use_log/logAnalyticsJson.png)

Copilot uses AI. Check for mistakes.
Comment on lines +12 to +21
Copy link

Copilot AI Jun 25, 2025

Choose a reason for hiding this comment

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

The alt text is generic; consider using a more descriptive alt text that explains what the image depicts for improved accessibility.

Suggested change
![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)
![List of Log Analytics workspaces in Azure Portal](../docs/images/re_use_log/logAnalyticsList.png)
### 3. Copy Resource ID
In the Overview pane, Click on JSON View
![Overview pane of a selected Log Analytics workspace in Azure Portal](../docs/images/re_use_log/logAnalytics.png)
Copy Resource ID that is your Workspace ID
![JSON view of a Log Analytics workspace showing the Resource ID](../docs/images/re_use_log/logAnalyticsJson.png)

Copilot uses AI. Check for mistakes.
Comment on lines +12 to +21
Copy link

Copilot AI Jun 25, 2025

Choose a reason for hiding this comment

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

The alt text is generic; consider providing a more descriptive alt text to better convey the context of this image for accessibility purposes.

Suggested change
![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)
![Screenshot of the Azure Portal showing a list of Log Analytics workspaces.](../docs/images/re_use_log/logAnalyticsList.png)
### 3. Copy Resource ID
In the Overview pane, Click on JSON View
![Screenshot of the Overview pane in the Azure Portal showing the JSON View option.](../docs/images/re_use_log/logAnalytics.png)
Copy Resource ID that is your Workspace ID
![Screenshot of the JSON View in the Azure Portal showing the Resource ID for the Log Analytics workspace.](../docs/images/re_use_log/logAnalyticsJson.png)

Copilot uses AI. Check for mistakes.

### 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 '<Existing Log Analytics Workspace Id>'
```
Replace `<Existing Log Analytics Workspace Id>` 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).