Gerenciar a largura de banda de rede de um agente do Storage Mover
Neste artigo, você aprenderá a definir agendas de gerenciamento de largura de banda para seus agentes do Storage Mover.
Ao migrar seus arquivos e pastas para o Azure, você precisa considerar cuidadosamente a largura de banda de carregamento que deseja disponibilizar para cada um dos agentes do Storage Mover. Outras cargas de trabalho também podem depender de ter largura de banda suficiente disponível. Para tornar os agentes do Storage Mover um bom vizinho de outras cargas de trabalho na rede, você pode agendar limites para cada agente.
Pré-requisitos
Antes de definir uma agenda de largura de banda, primeiro você precisa implantar um recurso do Storage Mover em um dos grupos de recursos e, em seguida , registrar um agente. As agendas de limite de largura de banda são definidas e armazenadas por agente registrado.
Entendendo o conceito básico de gerenciamento de largura de banda
Uma agenda é um atributo de um agente registrado. No portal, você pode definir e alterar esse cronograma na página de agentes registrados, encontrada no recurso Storage Mover.
Um cronograma de gerenciamento de largura de banda descreve janelas de tempo ao longo de uma semana, durante as quais você pode definir um limite de largura de banda de upload que um agente do Storage Mover pode usar.
Este cronograma se parece muito com um calendário no outlook, mas há algumas diferenças importantes:
- O calendário repete-se. Tem os sete dias úteis e no final da semana, o horário repete-se.
- Uma inscrição na lista é um limite designado que o agente não deve exceder. Alongamentos de tempo limpos em um dia não indicam limitação, permitindo que o agente use a largura de banda necessária.
- Não é possível agendar um limite para uma data específica, mas para repetir dias da semana. Como exemplo, você pode dizer: "Limite a largura de banda do agente a não mais do que x durante minha janela de backup na nuvem aos domingos."
- A agenda não armazena um fuso horário. Quando você define um limite que começa, por exemplo, às 9h, isso significa hora local do agente. Você pode ver qual fuso horário está configurado para o agente. Preste muita atenção, o fuso horário do agente pode ser diferente do fuso horário do seu site onde o agente está implantado.
Gorjeta
Você pode definir o fuso horário de um agente do Storage Mover para onde ele é implantado.
1. Conecte-se ao console do agente e faça login
2. Selecione a opção do menu: 1) System configuration
3. Selecione a opção de menu: 3) Change timezone e siga as instruções para fazer sua seleção.
Habilitando ou alterando um cronograma de gerenciamento de largura de banda
Usando o portal do Azure, você pode habilitar uma agenda de largura de banda em um recurso de agente registrado.
- Com o portal mostrando seu recurso Storage Mover, selecione "Agentes registrados" no menu à esquerda.
- Agora você tem duas opções para definir ou exibir uma agenda. Você pode encontrar a coluna "Gerenciamento de largura de banda" e clicar no link para o agente selecionado. Ou, você pode selecionar a caixa de seleção na frente do seu agente. Isso permite e um botão de comando acima da lista de agentes, rotulado "Gerenciar limite de largura de banda".
- A janela de gerenciamento de largura de banda é aberta e exibe o agendamento atualmente em vigor para o agente. Quando uma agenda vazia é mostrada, não há limitações de largura de banda definidas para esse agente.
Definição de um limite de largura de banda
Abra a janela de agendamento de largura de banda. (ver secção anterior)
Aqui você pode criar uma agenda personalizada para esse agente selecionado ou pode reutilizar uma agenda que foi criada anteriormente para outro agente.
- Para criar uma agenda personalizada, selecione o comando "Adicionar limite". Uma caixa de diálogo é aberta, permitindo que você defina uma fatia de tempo durante a qual você deseja definir a largura de banda máxima em seu link WAN, que o agente tem permissão para usar.
A caixa de diálogo requer que você defina uma hora de início e uma hora de término durante a qual você deseja aplicar um limite de uplink para o agente. Em seguida, você pode escolher em quais dias da semana você gosta de aplicar seu novo limite. Selecione todos os dias da semana durante os quais deseja aplicar o mesmo limite. Em seguida, você precisa especificar o limite em Mbps (Megabits por segundo). Não são permitidos tempos sobrepostos. Qualquer limite definido aplica-se à hora exibida no fuso horário do agente. Você pode encontrar o fuso horário do agente exibido na parte superior da janela de gerenciamento de largura de banda. Pode ser necessário alterar sua agenda ou ajustar o fuso horário do agente. - Para "reutilizar uma agenda de outro agente", siga o link para uma próxima seção.
- Para aplicar suas alterações a este agente, selecione o botão "Salvar" na parte inferior da janela "Gerenciamento de largura de banda".
Nota
Somente o fluxo de dados de migração que um agente estabelece para seu armazenamento de destino no Azure é controlado por essa agenda. Além desse fluxo de dados, há tráfego de plano de controle do agente para o Azure. Mensagens de controle, telemetria de progresso e logs de cópia geralmente exigem apenas uma pequena quantidade de largura de banda. Para garantir a funcionalidade adequada do agente durante toda a migração, o plano de controle do agente não é regido pela programação definida. Em um caso extremo, o agente pode exceder os limites definidos por uma pequena quantidade.
Gorjeta
Você pode definir o fuso horário de um agente do Storage Mover para onde ele é implantado.
1. Conecte-se ao console do agente e faça login
2. Selecione a opção do menu: 1) System configuration
3. Selecione a opção de menu: 3) Change timezone e siga as instruções para fazer sua seleção.
Alterar ou eliminar um limite de largura de banda
Abra a agenda de gerenciamento de largura de banda para o agente selecionado. (ver secção anterior)
Se você quiser editar ou excluir um limite específico, selecione o limite e a caixa de diálogo "Editar limite" será aberta. Você pode ajustar o intervalo de tempo ou excluir o limite. Não há opções de edição em massa, então você deve editar cada limite em cada dia da semana individualmente.
Se o seu objetivo for desativar completamente o gerenciamento de largura de banda para o agente, selecione o comando "Limpar todos os limites".
Não se esqueça de aplicar suas alterações a este agente. Selecione o botão "Salvar" na parte inferior da janela "Gerenciamento de largura de banda".
Reutilizar uma agenda de outro agente
Você pode reutilizar o agendamento de limite de largura de banda de outro agente.
- Abra a agenda de gerenciamento de largura de banda para o agente selecionado. Ver parágrafo anterior.
- Selecione o comando "Importar limites de outros agentes" e selecione o agente do qual você deseja copiar a programação. Se não houver agentes na lista, não haverá outros agentes com limites de largura de banda habilitados.
Aviso
O uso dessa opção substituirá o agendamento configurado atualmente para esse agente. Não é possível restaurar quaisquer alterações não guardadas que possa ter feito antes de importar uma agenda.
- Opcionalmente, agora você pode modificar essa agenda copiada.
- Para aplicar suas alterações a este agente, selecione o botão "Salvar" na parte inferior da janela "Gerenciamento de largura de banda".
Importante
As agendas são armazenadas livres de um fuso horário. Isso permite que eles sejam reutilizados em outros agentes. Um limite programado estará em vigor durante este período em qualquer que seja o fuso horário do agente. Você precisa garantir que você compense sua agenda de gerenciamento de largura de banda se o fuso horário do agente for diferente daquele usado no local em que você implantou o agente. Por exemplo, se o fuso horário do agente for UTC, mas o agente estiver realmente implantado no fuso horário do Pacífico (PST), você precisará compensar sua programação em -7 horas. Como alternativa, você pode ajustar o fuso horário do agente para o correto para o local. Fazer isso elimina a necessidade de compensar sua programação e também permite que sua agenda se ajuste automaticamente ao horário de verão, caso seu fuso horário observe isso.
Gorjeta
Você pode definir o fuso horário de um agente do Storage Mover para onde ele é implantado.
1. Conecte-se ao console do agente e faça login
2. Selecione a opção do menu: 1) System configuration
3. Selecione a opção de menu: 3) Change timezone e siga as instruções para fazer sua seleção.
Usar o PowerShell para configurar uma agenda de limite de largura de banda
Gerenciar esse recurso é possível ao usar a versão mais recente do módulo do Azure PowerShell.
Preparar seu ambiente do Azure PowerShell
- Se você optar por usar o Azure PowerShell localmente:
- Instale a versão mais recente do módulo Az PowerShell.
- Conecte-se à sua conta do Azure usando o cmdlet Connect-AzAccount .
- Se você optar por usar o Azure Cloud Shell:
- Consulte Visão geral do Azure Cloud Shell para obter mais informações.
Você precisa do Az.StorageMover módulo:
## Ensure you are running the latest version of PowerShell 7
$PSVersionTable.PSVersion
## Your local execution policy must be set to at least remote signed or less restrictive
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
## If you don't have the general Az PowerShell module, install it first
Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force
## Lastly, the Az.StorageMover module is not installed by default and must be manually requested.
Install-Module -Name Az.StorageMover -Scope CurrentUser -Repository PSGallery -Force
Gerenciar um cronograma de limite de largura de banda
## Set variables
$subscriptionID = "Your subscription ID"
$resourceGroupName = "Your resource group name"
$storageMoverName = "Your storage mover resource name"
$registeredAgentName = "Name of the agent, registered to your storage mover resource"
## Log into Azure with your Azure credentials
Connect-AzAccount -SubscriptionId $subscriptionID # -DeviceLogin #Leverage DeviceLogin if you need to authenticate your PowerShell session from another machine. # -TenantID #In some environments you may you need to specify the EntraID tenant to authenticate against.
#------------
# GET the schedule configured on an agent:
$schedule = @(Get-AzStorageMoverAgent -ResourceGroupName $resourceGroupName -StorageMoverName $storageMoverName -AgentName $registeredAgentName).UploadLimitScheduleWeeklyRecurrence
# $schedule then contains a JSON structure with elements for each configured time windows and the upload limit in Mbps that applies during this window.
# Output the entire schedule
$schedule
# Schedule elements can be addressed like an array.
$schedule[0]
Adicionar uma nova limitação de largura de banda
$newLimit = New-AzStorageMoverUploadLimitWeeklyRecurrenceObject `
-Day "Monday", "Tuesday" ` # Mandatory. An array, limited to the English names of all 7 days, Monday through Sunday in any order.
-LimitInMbps 900 ` # Mandatory. Limit in "Mega bits per second"
-StartTimeHour 5 ` # Mandatory. 24-hour clock: 5 = 5am
-EndTimeHour 17 ` # Mandatory. 24-hour clock: 17 = 5pm
-EndTimeMinute 30 # Optional. Time blocks are precise to 30 Minutes. -EndTimeMinute 0 is equivalent to omitting the parameter. The only other acceptable value is the half hour mark: 30.
$schedule += $newLimit # Appends the new limit to the exiting schedule. The JSON structure does not need to be ordered by days or time.
# Updates the bandwidth limit schedule for the selected agent by adding the defined "time block" to the schedule.
# Ensure that the new limit does not overlap with an already configured limit in the schedule, otherwise the operation will fail.
Update-AzStorageMoverAgent `
-ResourceGroupName $resourceGroupName `
-StorageMoverName $storageMoverName `
-AgentName $registeredAgentName `
-UploadLimitScheduleWeeklyRecurrence $schedule
# This command sets and overwrites a bandwidth limit schedule for the selected agent. Be sure to preserve an existing schedule if you want to only add a new limit. If you are building an entirely new schedule, you can form all your limit objects and then supply a comma-separated list of your new limits here.
# Ensure the new limit's time span is not overlapping any existing limits. Otherwise, the operation will fail.
Desativar a limitação de largura de banda para um agente
Update-AzStorageMoverAgent `
-ResourceGroupName $resourceGroupName `
-StorageMoverName $storageMoverName `
-AgentName $registeredAgentName `
-UploadLimitScheduleWeeklyRecurrence @() # Supply an empty array to remove all previously configured limits. This operation cannot be undone. You have to build and supply a new schedule if you want to enable bandwidth limitations for this agent again.
Alterar uma limitação de largura de banda existente
Você pode combinar as ações de gerenciamento descritas anteriormente para atualizar seletivamente uma limitação de largura de banda existente para um novo limite ou período de tempo atualizado.
# Step 1: define the new limit object you want to use to replace an existing limit:
$limit = New-AzStorageMoverUploadLimitWeeklyRecurrenceObject `
-Day "Monday", "Tuesday" ` # Mandatory. An array, limited to the English names of all 7 days, Monday through Sunday in any order.
-LimitInMbps 900 ` # Mandatory. limit in "Mega bits per second"
-StartTimeHour 5 ` # Mandatory. 24-hour clock: 5 = 5am
-EndTimeHour 17 ` # Mandatory. 24-hour clock: 17 = 5pm
-EndTimeMinute 30 # Optional. Time blocks are precise to 30 Minutes. -EndTimeMinute 0 is equivalent to omitting the parameter. The only other acceptable value is the half hour mark: 30.
# Step 2: Find the bandwidth limitation window you want to change:
$schedule = @(Get-AzStorageMoverAgent -ResourceGroupName $resourceGroupName -StorageMoverName $storageMoverName -AgentName $registeredAgentName).UploadLimitScheduleWeeklyRecurrence
$schedule[<n>] = $limit # Replace the limit (start count at zero) with your newly defined limit.
#Step 3: Update the bandwidth limit schedule for the selected agent:
Update-AzStorageMoverAgent `
-ResourceGroupName $resourceGroupName `
-StorageMoverName $storageMoverName `
-AgentName $registeredAgentName `
-UploadLimitScheduleWeeklyRecurrence $schedule # Apply your entire, updated schedule. Performing this step on an agent with other limits already configured will override them with this new schedule. Ensure there are no overlapping time spans, otherwise the operation will fail.
Compreendendo o esquema JSON de um agendamento de limite de largura de banda
O agendamento de limite de largura de banda é armazenado como uma construção JSON na propriedade UploadLimitScheduleWeeklyRecurrence de um agente registrado.
A seção anterior do PowerShell mostra um exemplo de como você pode formar e atualizar essa propriedade de agente usando o Azure PowerShell. No entanto, você pode formar manualmente esse JSON e fornecê-lo diretamente como um argumento para a propriedade. A seção a seguir pode ajudá-lo a entender os elementos de agendamento de largura de banda dessa construção JSON.
Importante
O cronograma consiste em um ou mais períodos de tempo durante os quais se aplica um limite de largura de banda que o agente não deve exceder. Estes períodos de tempo não devem sobrepor-se. A qualquer momento, apenas um limite pode ser aplicado. Um JSON especificando uma agenda com tempos sobrepostos é considerado malformado e não pode ser aplicado ao agente.
As duas representações a seguir de um cronograma de limite de largura de banda são equivalentes:
{
{
"startTime":
{
"hour": 7,
"minute": 0
},
"endTime":
{
"hour": 9,
"minute": 0
}
"days": ["Monday"],
"limitInMbps": 500
},
{
"startTime":
{
"hour": 9,
"minute": 0
},
"endTime":
{
"hour": 12,
"minute": 0
}
"days": ["Monday", "Tuesday", "Wednesday"],
"limitInMbps": 200
}
}
Nota
Períodos de tempo não cobertos por uma entrada na programação permitem que o agente utilize a largura de banda disponível. Durante esses períodos, é provável que um agente não utilize toda a largura de banda disponível. Você pode encontrar mais detalhes sobre isso no artigo de desempenho, seção: "Por que o desempenho da migração varia".
Próximos passos
Avance para um dos próximos artigos para saber como implantar um agente do Storage Mover ou criar um projeto de migração.