---
title: Traceroute
slug: aiops2/traceroute
description: Learn how to effectively use the traceroute feature in Atmos with this comprehensive document. Discover how to access, create, and execute traceroute tests, while understanding the scope and results of each test. Don't miss out on the opportunity to visua
docTags: 
createdAt: 2023-10-20T17:10:02.191Z
---

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

Ao clicar no botão Gráfico de execução é possível visualizar as métricas salvas dos traceroutes realizados na rotina. 

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

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