<!-- review: finished -->

<a id="monitoring"></a>

# Painel Web de Monitoramento Console Light

O Angie oferece uma ampla gama de possibilidades para monitorar seu funcionamento; além da API de [métricas](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#metrics) e do módulo [Prometheus](https://pt.angie.software//angie/docs/configuration/modules/http/http_prometheus.md#http-prometheus), você pode usar um console visual que é instalado junto ao servidor.

<a id="console-light"></a>

## Console Light

O Console Light é uma interface leve de monitoramento de atividade em tempo real que exibe métricas-chave de carga e desempenho do servidor. O console é baseado nas [capacidades da API](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#http-api) do Angie; os dados de monitoramento de atividade são gerados em tempo real. Além disso, o console permite [modificar](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#api-config) dinamicamente a configuração do Angie onde a própria API fornece essa capacidade.

Exemplo de um console implantado e configurado: [https://console.angie.software/](https://console.angie.software/)

<a id="version-history"></a>

## Histórico de Versões

| Versão   | Data de Lançamento   | Alterações                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|----------|----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1.8.2    | 23.01.2026           | Corrigido o link para a documentação do Angie ADC.                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 1.8.1    | 08.09.2025           | Corrigidos termos incorretos em Settings e tooltips.                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 1.8.0    | 03.07.2025           | Exibição de métricas de tempo de resposta<br/>para servidores HTTP e TCP/UDP proxificados                                                                                                                                                                                                                                                                                                                                                                                    |
| 1.7.2    | 07.04.2025           | Adicionada opção "busy" no controlador de filtro nas páginas HTTP/TCP/UDP Upstreams.                                                                                                                                                                                                                                                                                                                                                                                         |
| 1.7.1    | 04.04.2025           | Corrigidos valores incorretos nas tabelas HTTP/Location Zones na página HTTP Zones.                                                                                                                                                                                                                                                                                                                                                                                          |
| 1.7.0    | 02.04.2025           | - Exibição de volumes exatos de dados em bytes ao passar o mouse<br/>- Novo status `busy` para peers upstream na API de estatísticas,<br/>  indicando que um peer atingiu o limite configurado pelo parâmetro `max_conns`<br/>- Corrigidos links da documentação                                                                                                                                                                                                             |
| 1.6.1    | 27.01.2025           | - Corrigidos erros de digitação<br/>- Corrigido problema de build do projeto em tempo de desenvolvimento                                                                                                                                                                                                                                                                                                                                                                     |
| 1.6.0    | 23.01.2025           | - Suporte à internacionalização com locales disponíveis: `en`, `ru`.<br/>- Recurso de cabeçalho fixo adicionado ao componente de tabela.<br/>- Suporte para unidades de medida de dados em pebibytes (PiB).<br/>- Corrigido contador de valor incorreto no widget [HTTP Upstreams](#console-http-upstreams-widget) na página principal.<br/>- Valores padrão agora são usados corretamente na página [HTTP Upstreams](#console-http-upstreams-page) no contexto de resposta. |
| 1.5.0    |                      | Não lançado publicamente.                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 1.4.0    | 08.08.2024           | Adicionada exibição do status de monitoramento no favicon do site.                                                                                                                                                                                                                                                                                                                                                                                                           |
| 1.3.0    | 28.04.2024           | Adicionada a capacidade de definir um servidor para o estado `draining`<br/>no contexto upstream.                                                                                                                                                                                                                                                                                                                                                                            |
| 1.2.1    | 26.12.2023           | Adicionadas verificações de saúde ativas no contexto `Stream`.                                                                                                                                                                                                                                                                                                                                                                                                               |
| 1.2.0    | 25.12.2023           | Adicionada edição de servidor no contexto `Stream`.                                                                                                                                                                                                                                                                                                                                                                                                                          |

<a id="installation-and-configuration"></a>

## Instalação e Configuração

O Console Light é publicado como pacotes
`angie-console-light` (Angie)
e
`angie-pro-console-light` (Angie PRO)
em
[nossos repositórios](https://pt.angie.software//angie/docs/installation/index.md#install-packages)
e pode ser instalado como qualquer outro pacote;
alternativamente, você pode baixar o código-fonte
[do nosso site](https://download.angie.software/files/angie-console-light/)
ou
[GitHub](https://github.com/webserver-llc/angie-console-light).

Após a instalação,
configure o console adicionando a seguinte [location](https://pt.angie.software//angie/docs/configuration/modules/http/index.md#location)
dentro de um bloco [server](https://pt.angie.software//angie/docs/configuration/modules/http/index.md#server) na
[configuração do servidor](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)
(observe os comentários):

```nginx
location /console/ {

    # Acesso apenas local
    allow 127.0.0.1;
    deny all;

    auto_redirect on;

    alias /usr/share/angie-console-light/html/;
    # Apenas FreeBSD:
    # alias /usr/local/www/angie-console-light/html/;
    index index.html;

    location /console/api/ {
        api /status/;
    }

    # Para que os recursos de edição funcionem após autenticação (apenas PRO)
    location /console/api/config/ {

        auth_basic           "Site protegido";
        auth_basic_user_file conf/htpasswd;

        api /config/;
    }
}
```

Não se esqueça de aplicar a configuração modificada:

```console
$ sudo angie -t && sudo service angie reload
```

Após isso, o console estará disponível
no servidor especificado pelo bloco `server`,
no caminho especificado para a `location`;
no exemplo acima, o caminho é definido como `/console/`.

A autenticação pode ser habilitada para qualquer seção da API
similar ao exemplo acima, por exemplo:

```nginx
location /console/server_zones/ {
    auth_basic           "Site protegido";
    auth_basic_user_file conf/htpasswd;
}
```

Você também pode restringir o acesso a qualquer seção
da `location` do console configurada, por exemplo:

```nginx
location /console/api/resolvers/ {
    deny all;
}
```

<a id="interface"></a>

## Interface

O console é uma tela única com um conjunto de abas,
cada uma contendo vários widgets com dados de monitoramento.

<a id="angie-tab"></a>

### Aba Angie

![Console Light - tela principal](../../_images/console_light/en/main.png)

Esta é a aba principal onde os principais indicadores de monitoramento do Angie
são exibidos de forma resumida, baseados em dados de várias seções da API.

#### NOTE
Os widgets de estatísticas são exibidos
se os blocos correspondentes estiverem configurados na [configuração do Angie](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile).

<a id="about-widget"></a>

#### Widget About

Exibe o número da versão do Angie com um link para a
documentação correspondente, bem como o endereço do servidor e o horário do último [recarregamento de configuração](https://pt.angie.software//angie/docs/configuration/runtime.md#control-config-change).

Adicionalmente, se a diretiva [api_config_files](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#a-api-config-files) estiver habilitada,
o link *Configs* abre uma lista de arquivos de configuração
carregados no servidor.
Cada arquivo pode então ser visualizado em formato compacto com destaque de sintaxe.

<a id="connections-widget"></a>

#### Widget Connections

Exibe estatísticas básicas de conexão do servidor, geradas a partir da
seção da API `/status/connections/`:

| `Current`    | Número atual de conexões               |
|--------------|----------------------------------------|
| `Accepted/s` | Número de conexões aceitas por segundo |
| `Active`     | Número de conexões ativas              |
| `Idle`       | Número de conexões ociosas             |
| `Dropped`    | Número de conexões descartadas         |

Também disponível:

| `Accepted`   | Número total de conexões aceitas desde o último recarregamento do servidor   |
|--------------|------------------------------------------------------------------------------|

<a id="http-zones-widget"></a>

#### Widget HTTP Zones

#### WARNING
Requer definir a diretiva [status_zone](https://pt.angie.software//angie/docs/configuration/modules/http/index.md#status-zone)
em um contexto `server` ou `location`.

Exibe estatísticas de zona de memória compartilhada para o contexto `http`,
geradas a partir da seção da API [/status/http/server_zones/](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#api-status-http-server-zones):

| `Total`    | Número total de zonas                      |
|------------|--------------------------------------------|
| `Problems` | Número de zonas com quaisquer problemas    |
| `Traffic`  | Volume total de tráfego de entrada e saída |

<a id="console-http-upstreams-widget"></a>

#### Widget HTTP Upstreams

#### WARNING
Requer definir a diretiva [zone](https://pt.angie.software//angie/docs/configuration/modules/http/http_upstream.md#u-zone)
em um bloco [upstream](https://pt.angie.software//angie/docs/configuration/modules/http/http_upstream.md#u-upstream) no contexto `http`.

Exibe estatísticas de upstream para o contexto `http`, geradas a partir da
seção da API [/status/http/upstreams/](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#api-status-http-upstreams):

| Total    | Número total de upstreams                     |
|----------|-----------------------------------------------|
| Problems | Número de upstreams com quaisquer problemas   |
| Servers  | Estatísticas de servidor divididas por estado |

<a id="tcp-udp-zones-widget"></a>

#### Widget TCP/UDP Zones

#### WARNING
Requer definir as seguintes diretivas:

- `status_zone`
  em um contexto [server](https://pt.angie.software//angie/docs/configuration/modules/http/index.md#status-zone) ou [stream](https://pt.angie.software//angie/docs/configuration/modules/stream/index.md#s-status-zone);
- `limit_conn`
  em um contexto [server](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#limit-conn) ou [stream](https://pt.angie.software//angie/docs/configuration/modules/stream/stream_limit_conn.md#s-limit-conn);
- [limit_conn_zone](https://pt.angie.software//angie/docs/configuration/modules/http/http_limit_conn.md#limit-conn-zone) no contexto `stream`.

Exemplo:

```nginx
stream {

    # ...
    limit_conn_zone $connection zone=limit-conn-stream:10m;

    server {

        # ...
        limit_conn limit-conn-stream 1;
        status_zone foo;
    }
}
```

Exibe estatísticas de zona de memória compartilhada para o contexto `stream`,
geradas a partir da seção da API [/status/stream/server_zones/](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#api-status-stream-server-zones):

| Conn total   | Número total de conexões de cliente        |
|--------------|--------------------------------------------|
| Conn current | Número atual de conexões de cliente        |
| Conn/s       | Número de conexões processadas por segundo |

<a id="tcp-udp-upstreams-widget"></a>

#### Widget TCP/UDP Upstreams

#### WARNING
Requer definir a diretiva [zone](https://pt.angie.software//angie/docs/configuration/modules/stream/stream_upstream.md#s-u-zone)
em um bloco [upstream](https://pt.angie.software//angie/docs/configuration/modules/stream/stream_upstream.md#s-u-upstream) no contexto `stream`.

Exibe estatísticas de upstream para o contexto `stream`, geradas a partir da
seção da API [/status/stream/upstreams/](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#api-status-stream-upstreams):

| Total    | Número total de upstreams                     |
|----------|-----------------------------------------------|
| Problems | Número de upstreams com quaisquer problemas   |
| Servers  | Estatísticas de servidor divididas por estado |

<a id="http-zones-tab"></a>

### Aba HTTP Zones

#### WARNING
Requer definir a diretiva [status_zone](https://pt.angie.software//angie/docs/configuration/modules/http/index.md#status-zone)
em um contexto `server` ou `location`.

<a id="server-zones-section"></a>

#### Seção Server Zones

![Console Light — Seção "Server Zones" na aba "HTTP Zones"](../../_images/console_light/en/http-server-zones.png)

Resume as estatísticas de monitoramento de zona de memória compartilhada para o contexto `server`
em `http`, geradas a partir da seção da API [/status/http/server_zones/](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#api-status-http-server-zones). Os seguintes dados são apresentados para
cada zona:

| Zone      | Nome da zona                                                                                                                                             |
|-----------|----------------------------------------------------------------------------------------------------------------------------------------------------------|
| Requests  | Número total de requisições e o número de requisições por segundo                                                                                        |
| Responses | Número de respostas divididas por códigos de status,<br/>bem como seu número total                                                                       |
| Traffic   | Taxas de tráfego de saída e entrada, bem como volumes totais de tráfego de saída<br/>e entrada                                                           |
| SSL       | Contagens agregadas de: handshakes SSL bem-sucedidos; reutilizações de sessão SSL;<br/>handshakes SSL com timeout expirado; handshakes SSL mal-sucedidos |

<a id="location-zones-section"></a>

#### Seção Location Zones

![Console Light — Seção "Location Zones" na aba "HTTP Zones"](../../_images/console_light/en/http-location-zones.png)

Resume as estatísticas de monitoramento de zona de memória compartilhada para o contexto `location`
em `http`, geradas a partir da seção da API [/status/http/location_zones/](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#api-status-http-location-zones). Os seguintes dados são apresentados para
cada zona:

| Zone      | Nome da zona                                                                                   |
|-----------|------------------------------------------------------------------------------------------------|
| Requests  | Número total de requisições e o número de requisições por segundo                              |
| Responses | Número de respostas divididas por códigos de status,<br/>bem como seu número total             |
| Traffic   | Taxas de tráfego de saída e entrada, bem como volumes totais de tráfego de saída<br/>e entrada |

<a id="connection-limit-zones-limit-conn-section"></a>

#### Seção Connection Limit Zones (Limit Conn)

![Console Light — Seção "Connection Limit Zones" na aba "HTTP Zones"](../../_images/console_light/en/http-limit-conn.png)

Exibe estatísticas de zonas `limit_conn` no contexto `http`, geradas
a partir da seção da API [/status/http/limit_conns/](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#api-status-http-limit-conns). Os seguintes dados são apresentados para
cada zona:

| Zone      | Nome da zona                                                                        |
|-----------|-------------------------------------------------------------------------------------|
| Passed    | Número total de conexões com proxy                                                  |
| Rejected  | Número total de conexões rejeitadas                                                 |
| Exhausted | Número total de conexões descartadas devido ao estouro do armazenamento da zona     |
| Skipped   | Número total de conexões aprovadas com uma chave de zero ou maior que 255<br/>bytes |

<a id="request-limit-zones-limit-req-section"></a>

#### Seção Request Limit Zones (Limit Req)

![Console Light — Seção "Request Limit Zones" na aba "HTTP Zones"](../../_images/console_light/en/http-limit-req.png)

Exibe estatísticas de zonas `limit_reqs` no contexto `http`, geradas
a partir da seção da API [/status/http/limit_reqs/](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#api-status-http-limit-reqs). Os
seguintes dados são apresentados para cada zona:

| Zone      | Nome da zona                                                                           |
|-----------|----------------------------------------------------------------------------------------|
| Passed    | Número total de requisições com proxy                                                  |
| Delayed   | Número total de requisições atrasadas                                                  |
| Rejected  | Número total de requisições rejeitadas                                                 |
| Exhausted | Número total de requisições descartadas devido ao estouro do armazenamento da zona     |
| Skipped   | Número total de requisições aprovadas com uma chave de zero ou maior que 255<br/>bytes |

<a id="console-http-upstreams-page"></a>

### Aba HTTP Upstreams

![Console Light — Aba "HTTP Upstreams"](../../_images/console_light/en/http-upstreams.png)

#### WARNING
Requer definir a diretiva [zone](https://pt.angie.software//angie/docs/configuration/modules/http/http_upstream.md#u-zone)
em um bloco [upstream](https://pt.angie.software//angie/docs/configuration/modules/http/http_upstream.md#u-upstream) no contexto `http`.

Esta aba resume as estatísticas de monitoramento de upstream para o contexto `http`,
geradas a partir da seção da API [/status/http/upstreams/](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#api-status-http-upstreams).
No modo de depuração, a porcentagem de uso de memória também é exibida.

- O botão Show upstreams list alterna uma lista breve de upstreams
  com o número de upstreams e peers problemáticos.
- O interruptor Failed only alterna o modo de exibição para
  estatísticas de upstreams problemáticos.
- O botão de edição alterna a interface de upstream editing.
- A lista suspensa no lado direito de cada tabela de upstream permite filtrar
  servidores em um estado específico (Up, Failed, Checking,
  Down).

Para cada upstream, além de seu nome e taxa de utilização da zona de memória compartilhada,
os seguintes dados são apresentados:

| Server          | Nomes, tempos de inatividade e pesos dos servidores upstream                                                                                                                                         |
|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Requests        | Número total e taxa de processamento de requisições                                                                                                                                                  |
| Responses       | Número de respostas divididas por códigos de status                                                                                                                                                  |
| Connections     | Número de conexões ativas e seu limite máximo, se definido                                                                                                                                           |
| Traffic         | Taxas de tráfego de saída e entrada, bem como volumes totais de tráfego de saída<br/>e entrada                                                                                                       |
| Server checks   | Número de tentativas mal-sucedidas de contatar o servidor e o número de vezes<br/>que o servidor foi considerado indisponível (o objeto `health` na API)                                             |
| Health monitors | Número total de verificações de servidor, número de<br/>verificações mal-sucedidas e o horário da última verificação                                                                                 |
| Response time   | Tempo desde o início da requisição até o envio do primeiro byte da resposta;<br/>tempo total desde o início da requisição até a conclusão do envio de toda a resposta<br/>(o objeto `health` na API) |

<a id="console-http-upstreams-editing"></a>

#### Editando upstreams

No Angie PRO, há um botão de edição ao lado de cada upstream; quando clicado,
ele exibe dois botões adicionais:

| `Edit selected`   | Editar servidores selecionados dentro de um upstream. Permite definir<br/>os seguintes parâmetros para todos de uma vez: `Weight`,<br/>limite máximo de conexões (`Max_conns`), limite máximo de falhas<br/>que marca um servidor como indisponível (`Max_fails`), janela<br/>de tempo para contar falhas para o limite máximo de falhas<br/>(`Fail_timeout`), estado (`active` – habilitado,<br/>`down` – desabilitado, ou `draining` – recebe apenas<br/>requisições de sessões previamente vinculadas através de `sticky`).<br/><br/>Você também pode excluir os servidores selecionados aqui.<br/><br/>![Console Light — editando servidores<br/>na aba "HTTP Upstreams"](../../_images/console_light/en/http_upstreams_edit_servers.png)   |
|-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `Add server`      | Adicionar um servidor ao upstream. Permite definir os seguintes parâmetros:<br/>endereço, servidor de backup ou não, `Weight`, limite máximo de<br/>conexões (`Max_conns`), limite máximo de falhas que marca um servidor<br/>como indisponível (`Max_fails`), janela de tempo para contagem<br/>de falhas (`Fail_timeout`), estado (`active` – habilitado,<br/>`down` – desabilitado, ou `draining` – recebe apenas<br/>requisições de sessões previamente vinculadas através de `sticky`).<br/><br/>![Console Light — adicionando um servidor<br/>na aba "HTTP Upstreams"](../../_images/console_light/en/http_upstreams_add_server.png)                                                                                                      |

<a id="samp-tcp-udp-zones-tab"></a>

### Aba `TCP/UDP Zones`

#### WARNING
Requer a configuração das seguintes diretivas:

- `status_zone`
  em um contexto [server](https://pt.angie.software//angie/docs/configuration/modules/http/index.md#status-zone) ou [stream](https://pt.angie.software//angie/docs/configuration/modules/stream/index.md#s-status-zone);
- `limit_conn`
  em um contexto [server](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#limit-conn) ou [stream](https://pt.angie.software//angie/docs/configuration/modules/stream/stream_limit_conn.md#s-limit-conn);
- [limit_conn_zone](https://pt.angie.software//angie/docs/configuration/modules/http/http_limit_conn.md#limit-conn-zone) no contexto `stream`.

Exemplo:

```nginx
stream {

    # ...
    limit_conn_zone $connection zone=limit-conn-stream:10m;

    server {

        # ...
        limit_conn limit-conn-stream 1;
        status_zone foo;
    }
}
```

<a id="samp-tcp-udp-zones-section"></a>

#### Seção `TCP/UDP Zones`

![Console Light — aba "TCP/UDP Zones"](../../_images/console_light/en/stream-zones.png)

Resume as estatísticas de monitoramento de zona de memória compartilhada para o contexto `server`
em `stream`, geradas a partir da seção da API [/status/stream/server_zones/](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#api-status-stream-server-zones). Os seguintes dados são apresentados para
cada zona:

| `Zone`        | Nome da zona                                                                                                        |
|---------------|---------------------------------------------------------------------------------------------------------------------|
| `Connections` | Número atual e total de conexões, bem como o número de conexões por<br/>segundo                                     |
| `Sessions`    | Número de sessões divididas por códigos de status,<br/>bem como seu número total                                    |
| `Traffic`     | Taxas de tráfego de saída e entrada, bem como volumes totais de tráfego de saída<br/>e entrada                      |
| `SSL`         | Contagens agregadas de: handshakes SSL bem-sucedidos; handshakes SSL mal-sucedidos;<br/>reutilizações de sessão SSL |

<a id="samp-connection-limit-zones-limit-conn-section"></a>

#### Seção `Connection Limit Zones (Limit Conn)`

![Console Light — seção "Connection Limit Zones" na aba "TCP/UDP Zones"](../../_images/console_light/en/stream-limit-conn.png)

Exibe estatísticas das zonas `limit_conn` no contexto `stream`, geradas
a partir da seção da API [/status/stream/limit_conns/](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#api-status-http-limit-conns). Os seguintes dados são apresentados para
cada zona:

| `Zone`      | Nome da zona                                                                       |
|-------------|------------------------------------------------------------------------------------|
| `Passed`    | Número total de conexões proxificadas                                              |
| `Rejected`  | Número total de conexões rejeitadas                                                |
| `Exhausted` | Número total de conexões descartadas devido ao estouro do armazenamento da zona    |
| `Skipped`   | Número total de conexões passadas com uma chave de zero ou maior que 255<br/>bytes |

<a id="samp-tcp-udp-upstreams-tab"></a>

### Aba `TCP/UDP Upstreams`

![Console Light — aba "TCP/UDP Upstreams"](../../_images/console_light/en/stream-upstreams.png)

#### WARNING
Requer a configuração da diretiva [zone](https://pt.angie.software//angie/docs/configuration/modules/stream/stream_upstream.md#s-u-zone)
em um bloco [upstream](https://pt.angie.software//angie/docs/configuration/modules/stream/stream_upstream.md#s-u-upstream) no contexto `stream`.

Esta aba resume as estatísticas de monitoramento de upstream para o contexto `stream`,
geradas a partir da seção da API [/status/stream/upstreams/](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#api-status-stream-upstreams).
No modo de depuração, a porcentagem de uso de memória também é exibida.

- O botão `Show upstreams list` alterna a exibição de uma lista resumida de upstreams
  com o número de upstreams e peers problemáticos.
- O interruptor `Failed only` habilita e desabilita o modo de exibição para
  estatísticas de upstreams problemáticos.
- O botão de edição abre o widget de `edição de upstream`.
- A lista suspensa no lado direito de cada tabela de upstream permite filtrar
  servidores em um estado específico (`Up`, `Failed`, `Checking`,
  `Down`).

Para cada upstream, os seguintes dados são apresentados:

| `Server`          | Nomes, tempos de inatividade e pesos dos servidores upstream                                                                                                                                                                                                     |
|-------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `Connections`     | Número de conexões ativas e seu limite máximo, se definido                                                                                                                                                                                                       |
| `Traffic`         | Taxas de tráfego de saída e entrada, bem como volumes totais de tráfego de saída e entrada                                                                                                                                                                       |
| `Server checks`   | Número de tentativas mal-sucedidas de contatar o servidor e o número de vezes<br/>que o servidor foi considerado indisponível (o objeto `health` na API)                                                                                                         |
| `Health monitors` | Número total de verificações do servidor, número de<br/>verificações mal-sucedidas e o horário da última verificação                                                                                                                                             |
| `Response time`   | Tempo gasto estabelecendo uma conexão com o backend;<br/>tempo desde o início da requisição até receber o primeiro byte da resposta;<br/>tempo total decorrido desde o início da requisição até receber o último byte da resposta<br/>(o objeto `health` na API) |

<a id="console-stream-upstreams-editing"></a>

#### Editando upstreams

No Angie PRO, há um botão de edição ao lado de cada upstream; quando clicado,
ele exibe dois botões adicionais:

| `Edit selected`   | Editar servidores selecionados dentro de um upstream. Permite definir<br/>os seguintes parâmetros para todos de uma vez: `Weight`,<br/>limite máximo de conexões (`Max_conns`), limite máximo de falhas<br/>que marca um servidor como indisponível (`Max_fails`), janela<br/>de tempo para contar falhas para o limite máximo de falhas<br/>(`Fail_timeout`), estado (`active` – habilitado,<br/>`down` – desabilitado, ou `draining` – recebe apenas<br/>requisições de sessões previamente vinculadas através de `sticky`).<br/><br/>Você também pode excluir os servidores selecionados aqui.<br/><br/>![Console Light — editando servidores<br/>na aba "TCP/UDP Upstreams"](../../_images/console_light/en/http_upstreams_edit_servers.png)   |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `Add server`      | Adicionar um servidor ao upstream. Permite definir os seguintes parâmetros:<br/>endereço, servidor de backup ou não, `Weight`, limite máximo de<br/>conexões (`Max_conns`), limite máximo de falhas que marca um servidor<br/>como indisponível (`Max_fails`), janela de tempo para contagem<br/>de falhas (`Fail_timeout`), estado (`active` – habilitado,<br/>`down` – desabilitado, ou `draining` – recebe apenas<br/>requisições de sessões previamente vinculadas através de `sticky`).<br/><br/>![Console Light — adicionando um servidor<br/>na aba "TCP/UDP Upstreams"](../../_images/console_light/en/http_upstreams_add_server.png)                                                                                                      |

<a id="samp-caches-tab"></a>

### Aba `Caches`

![Console Light – aba "Caches"](../../_images/console_light/en/caches.png)

#### WARNING
Requer a configuração da diretiva [proxy_cache_path](https://pt.angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache-path)
no contexto `http`.

Esta aba resume as estatísticas de monitoramento para zonas `proxy_cache` no contexto `http`,
geradas a partir da seção da API [/status/http/caches/](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#api-status-http-caches). Os seguintes dados são apresentados para cada zona:

| `Zone`         | Nome da zona                                                                                    |
|----------------|-------------------------------------------------------------------------------------------------|
| `State`        | Estado do cache: cold (metadados sendo carregados na memória) ou hot<br/>(metadados carregados) |
| `Memory usage` | Taxa de utilização da memória                                                                   |
| `Max size`     | Tamanho máximo da memória                                                                       |
| `Used`         | Tamanho da memória utilizada                                                                    |
| `Disk usage`   | Taxa de utilização do disco                                                                     |
| `Traffic`      | Tráfego servido do cache, escrito no cache e retornado ignorando o cache                        |
| `Hit ratio`    | Taxa de acerto do cache (proporção do tráfego servido do cache em relação ao<br/>volume total)  |

Se o [sharding](https://pt.angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache) estiver habilitado para uma zona, ela é mostrada como uma
lista suspensa que lista os shards individuais:

| `Path`       | Caminho do shard no disco                                                                       |
|--------------|-------------------------------------------------------------------------------------------------|
| `State`      | Estado do shard: cold (metadados sendo carregados na memória) ou hot<br/>(metadados carregados) |
| `Max size`   | Tamanho máximo da memória                                                                       |
| `Used`       | Tamanho da memória utilizada                                                                    |
| `Disk usage` | Taxa de utilização do disco                                                                     |

<a id="samp-shared-zones-tab"></a>

### Aba `Shared Zones`

![Console Light – aba "Shared Zones"](../../_images/console_light/en/shared_zones.png)

Esta aba resume as estatísticas de monitoramento para **todas** as zonas de memória compartilhada
em todos os contextos. Os seguintes dados são apresentados para cada zona:

| `Zone`               | Nome da zona                              |
|----------------------|-------------------------------------------|
| `Total memory pages` | Número total de páginas de memória        |
| `Used memory pages`  | Número de páginas de memória utilizadas   |
| `Memory usage`       | Taxa de utilização da memória para a zona |

<a id="samp-dns-resolvers-tab"></a>

### Aba `DNS Resolvers`

![Console Light – aba "Resolvers"](../../_images/console_light/en/resolvers.png)

#### WARNING
Requer a configuração da diretiva [resolver](https://pt.angie.software//angie/docs/configuration/modules/http/index.md#resolver)
no contexto `http`.

Esta aba resume as estatísticas de consulta em zonas de memória compartilhada DNS,
geradas a partir da seção da API [/status/resolvers/](https://pt.angie.software//angie/docs/configuration/modules/http/http_api.md#api-status-resolvers).
Os seguintes dados são apresentados para cada zona:

| `Zone`      | Nome da zona                                                                                                                                                               |
|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `Requests`  | Número de requisições dos tipos A e AAAA, SRV, PTR                                                                                                                         |
| `Responses` | Número de respostas divididas pelos códigos correspondentes<br/>(`Success`, `Format error`, `Server failure`,<br/>`Name error`, `Not implemented`,<br/>`Refused` e outros) |

<a id="samp-settings-widget"></a>

### Widget `Settings`

![Console Light – widget "Settings"](../../_images/console_light/en/cog.png)

Permite configurar parâmetros gerais do console:

- Taxa de atualização de dados. Valor padrão – 1 seg.
- Taxa limite para status `4xx`. Quando o limite é atingido,
  avisos "amarelos" aparecem nas seções correspondentes relacionadas às respostas do servidor.
  Valor padrão – 7%.
- Janela de tempo para calcular a taxa de acerto do cache. Valor
  padrão – 300 seg.
- Limite de erro para o resolver. Quando o limite é atingido, o resolver
  ficará "vermelho". Valor padrão – 3%.
- Idioma da interface do console. Opções disponíveis: Inglês e Russo.
  Por padrão, o idioma do console é selecionado com base no locale definido no
  navegador.

<a id="console-control-panel"></a>

### Painel de Controle do Console

Em todas as abas, no meio do lado esquerdo da página, há um painel deslizante com
dois botões ![Console Light – botões de controle do console na aba "About"](../../_images/console_light/en/play.png). O botão superior pausa e retoma as atualizações de dados da API,
enquanto o botão inferior permite atualizar os dados manualmente quando as atualizações estão
pausadas.
