Excluir e recuperar um workspace do Azure Log Analytics

Artigo
12/29/2023

Este artigo explica o conceito de exclusão reversível do workspace do Azure Log Analytics e como recuperar um workspace excluído em um estado de exclusão temporária. Ele também explica como excluir um workspace permanentemente em vez de excluí-lo em um estado de exclusão temporária.

Permissões exigidas

Para excluir um workspace do Log Analytics em um estado de exclusão temporária ou permanentemente, você precisa de permissões microsoft.operationalinsights/workspaces/delete no workspace, conforme fornecido pela função interna de Colaborador do Log Analytics, por exemplo.
Para recuperar um workspace do Log Analytics em um estado de exclusão temporária, você precisa de permissões Microsoft.OperationalInsights/workspaces/write no workspace, conforme fornecido pela função interna de Colaborador do Log Analytics, por exemplo.

Considerações ao excluir um workspace

Quando você exclui um workspace do Log Analytics em um estado de exclusão temporária, uma operação de exclusão temporária é executada para permitir a recuperação do workspace, incluindo seus dados e agentes conectados dentro de 14 dias. Esse processo ocorre se a exclusão foi acidental ou intencional.

Após o período de exclusão reversível, o recurso de workspace e seus dados não são recuperáveis e são enfileirados para limpeza completa em 30 dias. O nome do workspace é liberado e você pode usá-lo para criar um novo workspace.

Observação

Se você quiser substituir o comportamento de exclusão temporária e excluir permanentemente o workspace, siga as etapas em Excluir um workspace permanentemente.

A operação de exclusão reversível exclui o recurso de workspace e a permissão de qualquer usuário associado é interrompida. Se os usuários estiverem associados a outros workspaces, eles poderão continuar usando o Log Analytics com esses outros workspaces.

Tenha cuidado ao excluir um workspace, pois pode haver dados e configurações importantes que podem afetar negativamente a operação de serviço. Examine os agentes, soluções e outros serviços do Azure que armazenam seus dados no Log Analytics, como:

Soluções de Gerenciamento.
Automação do Azure.
Agentes em execução em máquinas virtuais do Windows e do Linux.
Agentes em execução em computadores com Windows e Linux em seu ambiente.
System Center Operations Manager.

Excluir um workspace em um estado de exclusão temporária

A operação de exclusão do workspace remove o recurso do Azure Resource Manager do workspace. A configuração e os dados são mantidos por 14 dias, embora pareça que o workspace foi excluído. Todos os agentes e grupos de gerenciamento do System Center Operations Manager configurados para responder ao espaço de trabalho permanecem em um estado órfão durante o período de exclusão reversível. O serviço fornece um mecanismo para recuperar o workspace excluído, incluindo seus dados e recursos conectados, basicamente desfazendo a exclusão.

Observação

As soluções instaladas e os serviços vinculados, como a conta de Automação do Azure, são removidos permanentemente do espaço de trabalho no momento da exclusão e não podem ser recuperados. Esses recursos devem ser reconfigurados após a operação de recuperação para trazer o workspace de volta ao estado configurado anteriormente.

Entre no portal do Azure.
No portal do Azure, clique em Todos os serviços. Na lista de recursos, insira Log Analytics. Quando você começa a digitar, a lista é filtrada com base em sua entrada. Escolha workspaces do Log Analytics.
Na lista de workspaces do Log Analytics, selecione um workspace. Selecione Excluir.
Uma página de confirmação é exibida, mostrando a ingestão de dados no espaço de trabalho na última semana.
Insira o nome do workspace para confirmar e selecione Excluir.

Para excluir um workspace em um estado de exclusão temporária, chame a API Workspaces - Delete:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2022-10-01

Para excluir um workspace em um estado de exclusão temporária, execute o cmdlet Remove-AzOperationalInsightsWorkspace.

PS C:\>Remove-AzOperationalInsightsWorkspace -ResourceGroupName "resource-group-name" -Name "workspace-name"

Para excluir um workspace em um estado de exclusão temporária, execute o comando az monitor log-analytics workspace delete.

az monitor log-analytics workspace delete --resource-group MyResourceGroup --workspace-name MyWorkspace

Recuperar um workspace em um estado de exclusão temporária

Quando você exclui um workspace do Log Analytics acidental ou intencionalmente, o serviço coloca o workspace em um estado de exclusão reversível, e o torna inacessível a qualquer operação. O nome do workspace excluído é preservado durante o período de exclusão reversível. Ele não pode ser usado para criar um workspace. Após o período de exclusão temporária, o workspace se torna irrecuperável. Ele fica programado para exclusão permanente e seu nome é liberado e pode ser usado para criar um novo workspace.

Você pode recuperar o workspace durante o período de exclusão reversível, incluindo dados, configuração e agentes conectados. A recuperação do workspace é realizada através da recriação de um workspace do Log Analytics com os detalhes do workspace excluído, incluindo:

ID da assinatura
Nome do grupo de recursos
Nome do workspace
Região

Importante

Se o seu workspace foi excluído como parte da operação de exclusão do grupo de recursos, você deve primeiro recriar o grupo de recursos.

O espaço de trabalho e todos os seus dados são recuperados após a operação de recuperação. No entanto, as soluções e os serviços vinculados foram removidos permanentemente do workspace quando ele foi excluído em um estado de exclusão temporária. Esses recursos devem ser reconfigurados para trazer o workspace ao seu estado configurado anteriormente. Após a recuperação do workspace, alguns dados podem não estar disponíveis para consulta até que as soluções associadas sejam reinstaladas e seus esquemas sejam adicionados ao workspace.

Entre no portal do Azure.
No portal do Azure, clique em Todos os serviços. Na lista de recursos, insira Log Analytics. Quando você começa a digitar, a lista é filtrada com base em sua entrada. Escolha workspaces do Log Analytics. Você vê a lista de espaço de trabalhos no escopo selecionado.
Clique em Abrir lixeira no menu superior esquerdo para abrir uma página com workspaces no estado de exclusão temporária que podem ser recuperados.
Selecione o workspace. Em seguida, selecione Recuperar para recuperar o workspace.

Para recuperar o workspace, crie-o novamente com o mesmo nome, na mesma assinatura, grupo de recursos e local chamando a API Workspaces - Create or Update.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2022-10-01

Para recuperar um workspace em um estado de exclusão temporária, execute o cmdlet Restore-AzOperationalInsightsWorkspace.

PS C:\>Select-AzSubscription "subscription-name-the-workspace-was-in"
PS C:\>Restore-AzOperationalInsightsWorkspace -ResourceGroupName "resource-group-name-the-workspace-was-in" -Name "deleted-workspace-name" -Location "region-name-the-workspace-was-in"

Para recuperar um workspace em um estado de exclusão temporária, execute o comando az monitor log-analytics workspace recover:

az monitor log-analytics workspace recover --resource-group MyResourceGroup --workspace-name MyWorkspace

Excluir um workspace permanentemente

O método de exclusão reversível pode não se encaixar em alguns cenários, como desenvolvimento e teste, nos quais é necessário repetir uma implantação com as mesmas configurações e nome do workspace. Nesses casos, você pode excluir permanentemente o workspace e "substituir" o período de exclusão reversível. A operação de exclusão permanente do workspace libera o nome do workspace. Você pode criar um workspace usando o mesmo nome.

Importante

Use a operação de exclusão permanente do workspace com cuidado porque ela é irreversível. Você não poderá recuperar seu workspace e seus dados.
Se o workspace que você deseja excluir permanentemente estiver em um estado de exclusão temporária, primeiro você deverá recuperar o workspace antes de excluí-lo permanentemente.

Para excluir um workspace permanentemente usando o portal do Azure:

Entre no portal do Azure.
No portal do Azure, clique em Todos os serviços. Na lista de recursos, insira Log Analytics. Quando você começa a digitar, a lista é filtrada com base em sua entrada. Escolha workspaces do Log Analytics.
Na lista de workspaces do Log Analytics, selecione um workspace. Selecione Excluir.
Uma página de confirmação é exibida, mostrando a ingestão de dados no espaço de trabalho na última semana.
Selecione a caixa de seleção Excluir o workspace permanentemente.
Insira o nome do workspace para confirmar e selecione Excluir.

Para excluir um workspace permanentemente, chame a API Workspaces - Delete e adicionar o parâmetro de URI force:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2022-10-01&force=true

Para excluir um workspace permanentemente, execute o cmdlet Remove-AzOperationalInsightsWorkspace e adicione a marca -ForceDelete. A opção-ForceDelete está disponível no momento com Az.OperationalInsights 2.3.0 ou superior.

PS C:\>Remove-AzOperationalInsightsWorkspace -ResourceGroupName "resource-group-name" -Name "workspace-name" -ForceDelete

Para excluir um workspace permanentemente, execute o comando az monitor log-analytics workspace delete e adicione o parâmetro --force.

az monitor log-analytics workspace delete --force --resource-group MyResourceGroup --workspace-name MyWorkspace

Solução de problemas

Use a seção a seguir para solucionar problemas com a exclusão ou recuperação de um workspace do Log Analytics.

Não tenho certeza se o workspace que excluí pode ser recuperado

Se você não tiver certeza se um workspace excluído está no estado de exclusão temporária e se pode ser recuperado, no portal do Azure, selecione Abrir lixeira na página Workspaces do Log Analytics para ver uma lista de workspaces excluídos temporariamente por assinatura. Workspaces excluídos permanentemente não estão incluídos na lista.

Resolver a mensagem de erro "Este nome de workspace já está sendo usado" ou "conflito"

Se você receber uma dessas mensagens de erro ao criar um workspace, isso pode ser porque:

O nome do workspace não está disponível e está sendo usado por alguém em sua organização ou por outro cliente.
O workspace foi excluído durante os últimos 14 dias e seu nome ficou reservado para o período de exclusão reversível. Para resolver o problema, siga estas etapas:
1. Recuperar seu workspace em um estado de exclusão temporária, o que permite excluí-lo permanentemente.
2. Excluir permanentemente o workspace que você recuperou. Quando você exclui um workspace permanentemente, seu nome não é mais reservado.
3. Criar um workspace usando o mesmo nome.
Depois que a chamada de exclusão for concluída com êxito no back-end, você poderá restaurar o workspace e concluir a operação de exclusão permanente usando um dos métodos sugeridos anteriormente.

Estou recebendo código de resposta 204 com "Recurso não encontrado" ao excluir um workspace

Se você obtiver o código de resposta 204 com “Recurso não encontrado” ao excluir um workspace, podem ter ocorrido operações consecutivas de novas tentativas. O código 204 é uma resposta vazia, o que geralmente significa que o recurso não existe, portanto, a exclusão foi concluída sem fazer nada.

Estou recebendo o código de erro 404 ao tentar recuperar meu workspace

Se você excluiu seu grupo de recursos e seu workspace estava incluído, você pode ver o workspace excluído na página Abrir lixeira no portal do Azure. A operação de recuperação falhará com o código de erro 404 porque o grupo de recursos não existe. Recrie o grupo de recursos e tente recuperar novamente.

Próximas etapas

Se você precisa criar um workspace do Log Analytics, confira Criar um workspace do Log Analytics.