---
title: Traceroute
slug: aiops/traceroute
docTags: 
createdAt: 2024-09-03T17:04:37.762Z
---

As ferramentas de rede no Atmos contam com testes de traceroute para determinar o rastreio de pacotes da rede e sua conectividade.

Para acesso aos traceroutes, clique no botão **Rede** e em seguida, no menu superior, no botão **Traceroutes**.

::Image[]{src="https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/rf8qfW_SmilzLiqvWykHI_image.png" size="20" width="146" height="56" position="center" showCaption="false"}

::Image[]{src="https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/1iYr-WCg9PLoO7UzanO65_image.png" size="38" width="330" height="96" position="center" showCaption="false"}

A tela com a lista de traceroutes cadastrados será exibida.

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/lXfUq964GxJAnJ5eT5K2R_image.png)

## Criando uma rotina de testes do Traceroute

Ao clicar no botão **Novo traceroute**, no canto superior direito, a seguinte janela será exibida:

::Image[]{src="https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/5f4Tr0GukJiqfIrh15-ZG_image.png" size="80" width="805" height="630" caption="Aba Geral" position="center" showCaption="true"}

- **Nome**: Nome do grupo de testes;
- **Intervalo**: Intervalo de execução dos testes;
- **Saltos**: Número de saltos máximos a serem executados pelo traceroute;
- **Timeout**: Tempo limite para a execução do traceroute (para cada teste individual)
- **Tentativas**: Número de tentativas de execução;
- **Tipo**: Qual tipo de endereços IP utilizar (Quando não selecionado apenas o IP primário é utilizado por padrão);
  - **Somente IPs Públicos:** Selecione o principal *IP Público* do Item de Configuração (quando existir)
  - **Somente IPs Privados:** Selecione o principal *IP Privado* do Item de Configuração (quando existir)
- **Interface*** (Opcional)*: Interface que será utiulizada para execução dos testes (é necessário obter o nome da interface desejada na instância *atom-worker *do AIops)
- **Descrição** (Opcional): Descritivo do grupo de teste

### Escopo

A aba escopo define a origem dos IPS de destino deste grupo de coleta do traceroute (IP primário presente nos itens de configuração). 

::Image[]{src="https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/wGjv1IwLu3kIl-TYFE7OE_image.png" size="80" width="808" height="526" position="center" showCaption="false"}

:::hint{type="info"}
Para cada grupo de teste são escolhidos os *IPs* por Item de Configuração de acordo com o tipo definido da *Aba Geral*. 
:::

# Executando um teste do Traceroute

Este teste é executado em tempo real e não gera métricas, apenas retorna o resultado do traceroute para visualização.
Ao clicar no botão **Testar configuração de Traceroute ** a janela a seguir será exibida:

::Image[]{src="https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/f2REpTmzu7XKVa2-3j2Ev_image.png" size="80" width="759" height="406" position="center" showCaption="false"}

- **Destino**: Endereço de destino a ser executado (IP ou Domínio);
- **Interface*** (Opcional)*: Interface que será utiulizada para execução dos testes (é necessário obter o nome da interface desejada na instância *atom-worker *do aiops)
- **Saltos**: Número máximo de saltos na execução;
- **Timeout**: Tempo limite na execução do teste;
- **Tentativas**: Número de tentativas na execução.

### Resultado do teste

Na execução bem sucedida de um teste de traceroute a aba de resultados será exibida com o seguinte valor de exemplo:

::Image[]{src="https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/keKcFE5l5qcrxzJzvh286_image.png" size="80" width="759" height="478" caption="Teste realizado com o dominio google.com.br" position="center" showCaption="true"}

O resultado é um objeto do tipo JSON que contém as seguintes informações:

```json
{
    "address": "google.com.br"                  // destino do teste
    "elapsed_time_ms": 435,                     // tempo total (todos os saltos) em milliseconds
    "hops": [
        {
            "hop": 1,                   
            "success": true,            
            "address": "177.20.14.3",   
            "host": "177.20.14.3",     
            "rtt": 0 
        },
        // {...}
        {
            "hop": 13,                          // número do salto 
            "success": true,                    // se o probe retornou sucesso nesse salto
            "address": "172.217.162.13",        // ip do salto
            "host": "gru14s19-in-f3.1e100.net", // dominio ou ip resolvido
            "rtt": 28                           // tempo em ms do retorno do salto 
        }
    ],
    "hops_count": 13,                           // quantidade de saltos 
    "host": "google.com.br",                    // dominio do teste
    "ip": "172.217.162.131",                    // ip resolvido do dominio do teste
    "probe_version": "traceroute/binary:v1",    // versão do traceroute utilizado
    "reached": true                             // se o destino foi alcançado com sucesso
}
```

## Gráfico de execução



![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/SKovkCJ0ORTwBzOtj9ueg_image.png)