Aprimoramento do desempenho da rede com o ENA Express nas instâncias do EC2

Essa guia explica como encontrar informações sobre as configurações atuais do ENA Express e como visualizar os tipos de instância compatíveis no AWS Management Console.

Essa guia explica como encontrar informações sobre as configurações atuais do ENA Express e como visualizar os tipos de instância compatíveis no AWS CLI.

Descrever tipos de instância

Para obter informações sobre as configurações de um tipo de instância específico, execute o comando describe-instance-types na AWS CLI e substitua o tipo de instância da seguinte forma:

[ec2-user ~]$ aws ec2 describe-instance-types --instance-types m6i.metal
{
"InstanceTypes": [
{
	"InstanceType": "m6i.metal",
	"CurrentGeneration": true,
	...
	},
	"NetworkInfo": {
		...
		"EnaSrdSupported": true
	},
	...
}
]
}

Descrever instâncias

Para obter informações sobre a configuração do ENA Express para instâncias especificadas, execute o comando describe-instances na AWS CLI conforme mostrado a seguir. Esse exemplo de comando retorna uma lista de configurações do ENA Express para as interfaces de rede associadas a cada uma das instâncias em execução especificadas pelo parâmetro --instance-ids.

[ec2-user ~]$ aws ec2 describe-instances --instance-ids i-1234567890abcdef0 i-0598c7d356eba48d7 --query 'Reservations[*].Instances[*].[InstanceId, NetworkInterfaces[*].Attachment.EnaSrdSpecification]'[
	[
		[
			"i-1234567890abcdef0",
			[
				{
					"EnaSrdEnabled": true,
					"EnaSrdUdpSpecification": {
						"EnaSrdUdpEnabled": false
					}
				}
			]
		]
	],
	[
		[
			"i-0598c7d356eba48d7",
			[
				{
					"EnaSrdEnabled": true,
					"EnaSrdUdpSpecification": {
						"EnaSrdUdpEnabled": false
					}
				}
			]
		]
	]
]

Describe network interfaces

Para obter informações sobre as configurações do ENA Express para uma interface de rede, execute o comando describe-network-interfaces na AWS CLI da seguinte forma:

[ec2-user ~]$ aws ec2 describe-network-interfaces
{
"NetworkInterfaces": [
{
	"Association": {
		....IPs, DNS...
	},
	"Attachment": {
		"AttachTime": "2022-11-17T09:04:28+00:00",
		"AttachmentId": "eni-attach-0ab1c23456d78e9f0",
		"DeleteOnTermination": true,
		"DeviceIndex": 0,
		"NetworkCardIndex": 0,
		"InstanceId": "i-1234567890abcdef0",
		"InstanceOwnerId": "111122223333",
		"Status": "attached",
		"EnaSrdSpecification": {
			"EnaSrdEnabled": true,
			"EnaSrdUdpSpecification": {
				"EnaSrdUdpEnabled": true
			}
		}
	},
	...
	"NetworkInterfaceId": "eni-1234567890abcdef0",
	"OwnerId": "111122223333",
	...
}
]
}

Esta guia explica como encontrar informações sobre as configurações atuais do ENA Express e como visualizar os tipos de instância compatíveis usando o PowerShell.

Descrever tipos de instância

Para obter informações sobre configurações de tipo de instância para uma instância específica, execute o comando Get-EC2InstanceType Cmdlet no Tools for PowerShell e substitua o tipo de instância da seguinte forma:

PS C:\> Get-EC2InstanceType -InstanceType m6i.metal | `
Select-Object `
    InstanceType,
    CurrentGeneration,
    @{Name = 'EnaSrdSupported'; Expression = { $_.NetworkInfo.EnaSrdSupported } } | `
Format-List

InstanceType      : m6i.metal
CurrentGeneration : True
EnaSrdSupported   : True

Se o ENA Express estiver habilitado um valor de True será devolvido.

Describe network interfaces

Para obter informações sobre as configurações do ENA Express para uma interface de rede, execute o comando Get-EC2NetworkInterface Cmdlet com o Tools for PowerShell da seguinte forma:

PS C:\> Get-EC2NetworkInterface -NetworkInterfaceId eni-0d1234e5f6a78901b | `
Select-Object `
    Association, 
    NetworkInterfaceId, 
    OwnerId, 
    @{Name = 'AttachTime'; Expression = { $_.Attachment.AttachTime } },
    @{Name = 'AttachmentId'; Expression = { $_.Attachment.AttachmentId } },
    @{Name = 'DeleteOnTermination'; Expression = { $_.Attachment.DeleteOnTermination } },
    @{Name = 'NetworkCardIndex'; Expression = { $_.Attachment.NetworkCardIndex } },
    @{Name = 'InstanceId'; Expression = { $_.Attachment.InstanceId } },
    @{Name = 'InstanceOwnerId'; Expression = { $_.Attachment.InstanceOwnerId } },
    @{Name = 'Status'; Expression = { $_.Attachment.Status } },
    @{Name = 'EnaSrdEnabled'; Expression = { $_.Attachment.EnaSrdSpecification.EnaSrdEnabled } },
    @{Name = 'EnaSrdUdpEnabled'; Expression = { $_.Attachment.EnaSrdSpecification.EnaSrdUdpSpecification.EnaSrdUdpEnabled } }

Association         : 
NetworkInterfaceId  : eni-0d1234e5f6a78901b
OwnerId             : 111122223333
AttachTime          : 6/11/2022 1:13:11 AM
AttachmentId        : eni-attach-0d1234e5f6a78901b
DeleteOnTermination : True
NetworkCardIndex    : 0
InstanceId          : i-0d1234e5f6a78901b
InstanceOwnerId     : 111122223333
Status              : attached
EnaSrdEnabled       : True
EnaSrdUdpEnabled    : False

Essa guia explica como gerenciar as configurações do ENA Express para interfaces de rede anexadas a uma instância.

Essa guia explica como definir as configurações do ENA Express na AWS CLI.

Configurar o ENA Express ao anexar uma interface de rede

Para configurar o ENA Express ao anexar uma interface de rede a uma instância, execute o comando attach-network-interface na AWS CLI, conforme mostrado nos seguintes exemplos:

Exemplo 1: usar o ENA Express para tráfego TCP, mas não para tráfego UDP

Neste exemplo, configuramos EnaSrdEnabled como true (verdadeiro) e permitimos que EnaSrdUdpEnabled assuma o padrão false (falso).

[ec2-user ~]$ aws ec2 attach-network-interface --network-interface-id eni-0123f4567890a1b23 --instance-id i-0f1a234b5cd67e890 --device-index 1 --ena-srd-specification 'EnaSrdEnabled=true'
{
"AttachmentId": "eni-attach-012c3d45e678f9012"
}

Exemplo 2: usar o ENA Express para tráfego TCP e tráfego UDP

Neste exemplo, configuramos EnaSrdEnabled e EnaSrdUdpEnabled como true (verdadeiros).

[ec2-user ~]$ aws ec2 attach-network-interface --network-interface-id eni-0123f4567890a1b23 --instance-id i-0f1a234b5cd67e890 --device-index 1 --ena-srd-specification 'EnaSrdEnabled=true,EnaSrdUdpSpecification={EnaSrdUdpEnabled=true}'
{
"AttachmentId": "eni-attach-012c3d45e678f9012"
}

Atualizar as configurações do ENA Express para o anexo da interface de rede

Para atualizar as configurações do ENA Express para uma interface de rede anexada a uma instância, execute o comando modify-network-interface-attribute na AWS CLI, conforme mostrado nos seguintes exemplos:

Exemplo 1: usar o ENA Express para tráfego TCP, mas não para tráfego UDP

Neste exemplo, configuramos EnaSrdEnabled como true (verdadeiro) e permitimos que EnaSrdUdpEnabled assuma o padrão de false (falso) se nunca tiver sido definido antes.

[ec2-user ~]$ aws ec2 modify-network-interface-attribute --network-interface-id eni-0123f4567890a1b23 --ena-srd-specification 'EnaSrdEnabled=true'

Exemplo 2: usar o ENA Express para tráfego TCP e tráfego UDP

Neste exemplo, configuramos EnaSrdEnabled e EnaSrdUdpEnabled como true (verdadeiros).

[ec2-user ~]$ aws ec2 modify-network-interface-attribute --network-interface-id eni-0123f4567890a1b23 --ena-srd-specification 'EnaSrdEnabled=true,EnaSrdUdpSpecification={EnaSrdUdpEnabled=true}'

Exemplo 3: parar de usar o ENA Express para tráfego UDP

Neste exemplo, configuramos EnaSrdUdpEnabled como false (falso).

[ec2-user ~]$ aws ec2 modify-network-interface-attribute --network-interface-id eni-0123f4567890a1b23 --ena-srd-specification 'EnaSrdUdpSpecification={EnaSrdUdpEnabled=false}'

Esta guia explica como definir as configurações do ENA Express usando o PowerShell.

Configurar o ENA Express ao anexar uma interface de rede

Para definir as configurações do ENA Express para uma interface de rede, execute o comando Add-EC2NetworkInterface Cmdlet com o Tools for PowerShell conforme mostrado nos seguintes exemplos:

Exemplo 1: usar o ENA Express para tráfego TCP, mas não para tráfego UDP

Neste exemplo, configuramos EnaSrdEnabled como true (verdadeiro) e permitimos que EnaSrdUdpEnabled assuma o padrão false (falso).

PS C:\> Add-EC2NetworkInterface `
-NetworkInterfaceId eni-0123f4567890a1b23 `
-InstanceId i-0f1a234b5cd67e890 `
-DeviceIndex 1 `
-EnaSrdSpecification_EnaSrdEnabled $true

eni-attach-012c3d45e678f9012

Exemplo 2: usar o ENA Express para tráfego TCP e tráfego UDP

Neste exemplo, configuramos EnaSrdEnabled e EnaSrdUdpEnabled como true (verdadeiros).

PS C:\> Add-EC2NetworkInterface `
-NetworkInterfaceId eni-0123f4567890a1b23 `
-InstanceId i-0f1a234b5cd67e890 `
-DeviceIndex 1 `
-EnaSrdSpecification_EnaSrdEnabled $true `
-EnaSrdUdpSpecification_EnaSrdUdpEnabled $true

eni-attach-012c3d45e678f9012

Atualizar as configurações do ENA Express para o anexo da interface de rede

Para atualizar as configurações do ENA Express para uma interface de rede anexada a uma instância, execute o comando Add-EC2NetworkInterface Cmdlet no Tools for PowerShell conforme mostrado nos seguintes exemplos:

Exemplo 1: usar o ENA Express para tráfego TCP, mas não para tráfego UDP

Neste exemplo, configuramos EnaSrdEnabled como true (verdadeiro) e permitimos que EnaSrdUdpEnabled assuma o padrão de false (falso) se nunca tiver sido definido antes.

PS C:\> Edit-EC2NetworkInterfaceAttribute `
-NetworkInterfaceId eni-0123f4567890a1b23 `
-EnaSrdSpecification_EnaSrdEnabled $true ; 
Get-EC2NetworkInterface -NetworkInterfaceId eni-0123f4567890a1b23 | `
Select-Object `
    NetworkInterfaceId, 
    @{Name = 'EnaSrdEnabled'; Expression = { $_.Attachment.EnaSrdSpecification.EnaSrdEnabled }}, 
    @{Name = 'EnaSrdUdpEnabled'; Expression = { $_.Attachment.EnaSrdSpecification.EnaSrdUdpSpecification.EnaSrdUdpEnabled }} | `
Format-List

NetworkInterfaceId : eni-0123f4567890a1b23
EnaSrdEnabled      : True
EnaSrdUdpEnabled   : False

Exemplo 2: usar o ENA Express para tráfego TCP e tráfego UDP

Neste exemplo, configuramos EnaSrdEnabled e EnaSrdUdpEnabled como true (verdadeiros).

PS C:\> Edit-EC2NetworkInterfaceAttribute `
-NetworkInterfaceId eni-0123f4567890a1b23 `
-EnaSrdSpecification_EnaSrdEnabled $true `
-EnaSrdSpecification_EnaSrdUdpSpecification_EnaSrdUdpEnabled $true ;
Get-EC2NetworkInterface -NetworkInterfaceId eni-0123f4567890a1b23 | `
Select-Object `
    NetworkInterfaceId, 
    @{Name = 'EnaSrdEnabled'; Expression = { $_.Attachment.EnaSrdSpecification.EnaSrdEnabled }}, 
    @{Name = 'EnaSrdUdpEnabled'; Expression = { $_.Attachment.EnaSrdSpecification.EnaSrdUdpSpecification.EnaSrdUdpEnabled }} | `
Format-List

NetworkInterfaceId : eni-0123f4567890a1b23
EnaSrdEnabled      : True
EnaSrdUdpEnabled   : True

Exemplo 3: parar de usar o ENA Express para tráfego UDP

Neste exemplo, configuramos EnaSrdUdpEnabled como false (falso).

PS C:\> Edit-EC2NetworkInterfaceAttribute `
-NetworkInterfaceId eni-0123f4567890a1b23 `
-EnaSrdSpecification_EnaSrdUdpSpecification_EnaSrdUdpEnabled $false ; 
Get-EC2NetworkInterface -NetworkInterfaceId eni-0123f4567890a1b23 | `
Select-Object `
    NetworkInterfaceId, 
    @{Name = 'EnaSrdEnabled'; Expression = { $_.Attachment.EnaSrdSpecification.EnaSrdEnabled }}, 
    @{Name = 'EnaSrdUdpEnabled'; Expression = { $_.Attachment.EnaSrdSpecification.EnaSrdUdpSpecification.EnaSrdUdpEnabled }} | `
Format-List

NetworkInterfaceId : eni-0123f4567890a1b23
EnaSrdEnabled      : True
EnaSrdUdpEnabled   : False