[comment]: # ({4f11bfeb-168e8cde})
# 21 Gráfico de pizza
[comment]: # ({/4f11bfeb-168e8cde})
[comment]: # ({0ad6140e-5cc3e4a5})
#### Visão geral
O widget *Pie chart* exibe dados numéricos de item como um gráfico de pizza ou de rosca baseado em vetores.
Este widget pode ajudar você a visualizar como itens ou hosts contribuem para o conjunto de dados geral.
| | |
|-|-|
|{width="400"}|{width="400"}|
Ao passar o mouse, o setor em foco se expande e mostra sua legenda; ao clicar no setor, ele permanece expandido e sua legenda fica visível até ser fechada.
As informações exibidas no widget *Pie chart* podem ser baixadas como uma imagem PNG selecionando a opção *Download image* no [menu do widget](/manual/web_interface/frontend_sections/dashboards#widget-menu).
[comment]: # ({/0ad6140e-5cc3e4a5})
[comment]: # ({eff3502a-93b70ac4})
#### Configuração
Para configurar, selecione *Gráfico de pizza* como tipo:
{width="600"}
[comment]: # ({/eff3502a-93b70ac4})
[comment]: # ({3ecdd5a0-013fdb30})
#### Conjunto de dados
A aba **Conjunto de dados** permite selecionar dados para o gráfico de pizza adicionando conjuntos de dados.
Dois tipos de conjuntos de dados podem ser adicionados:
- *Padrões de item* - dados de itens correspondentes são exibidos.
Você pode escolher uma única cor base ou selecionar uma linha da paleta para atribuir cores distintas a cada item correspondente.
- *Lista de itens* - dados dos itens selecionados são exibidos.
Você pode escolher a cor de cada item individualmente no seletor.
Por padrão, um conjunto de dados de *Padrões de item* é adicionado.
| | | |
|-|----------|----------------------------------------|
|*Conjunto de dados*|<|Para o conjunto de dados *Padrões de item*:
Selecione ou insira padrões de host e item; os dados dos itens que corresponderem aos padrões informados serão exibidos no gráfico de pizza; até 50 itens podem ser exibidos.
Padrões curinga podem ser usados para seleção (por exemplo, `*` retornará resultados que correspondem a zero ou mais caracteres).
Para especificar um padrão curinga, digite a string manualmente e pressione *Enter*.
O símbolo curinga é sempre interpretado, portanto não é possível adicionar, por exemplo, um item chamado *item\** individualmente se houver outros itens correspondentes (por exemplo, *item2*, *item3*).
Especificar padrões de host e item é obrigatório para conjuntos de dados "Padrões de item".
Veja também: [Detalhes da configuração do conjunto de dados](#data-set-configuration-details).
Para o conjunto de dados *Lista de itens*:
Selecione itens para o gráfico de pizza clicando no botão *Adicionar item*.
O menu suspenso *Tipo* após o nome do item permite selecionar o tipo de exibição de cada item:
**Normal** - o valor do item é representado proporcionalmente no gráfico de pizza (padrão);
**Total** - o valor do item ocupa todo o gráfico de pizza. Observe que apenas um item "Total" pode existir por gráfico de pizza, e ele será colocado primeiro na legenda do gráfico de pizza. Se um item for definido como "Total", o parâmetro *Agregação do conjunto de dados* (veja abaixo) será desativado e definido como "não usado".
Você também pode selecionar widgets compatíveis como [fonte de dados](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) para itens clicando no botão *Adicionar widget*. As mesmas opções se aplicam a widgets e a itens individuais.
Especificar itens ou widgets é obrigatório para conjuntos de dados "Lista de itens".
Veja também: [Detalhes da configuração do conjunto de dados](#data-set-configuration-details).
Observe que somente tipos numéricos de item são permitidos.
Ao configurar o widget em um [dashboard de template](/manual/config/templates/template#adding-dashboards), o parâmetro para especificar padrões de host não está disponível, e o parâmetro para especificar uma lista de itens permite selecionar apenas os [itens configurados no template](/manual/config/templates/template#adding-items-triggers-graphs).|
| |*Função de agregação*|Especifique qual função de agregação usar para cada item no conjunto de dados dentro do [*Período de tempo*](#time-period) selecionado:
**min** - exibe o menor valor;
**max** - exibe o maior valor;
**avg** - exibe o valor médio;
**sum** - exibe a soma dos valores;
**count** - exibe a contagem de valores;
**first** - exibe o primeiro valor;
**last** - exibe o último valor (padrão).
A agregação permite exibir um valor agregado para o intervalo escolhido (5 minutos, uma hora, um dia).
Apenas dados numéricos podem ser exibidos para *min*, *max*, *avg* e *sum*. Para *count*, dados não numéricos serão convertidos em numéricos.|
|^|*Agregação do conjunto de dados*|Especifique qual função de agregação usar para todo o conjunto de dados:
**não usado** - sem agregação, os itens são exibidos separadamente (padrão);
**min** - exibe o menor valor;
**max** - exibe o maior valor;
**avg** - exibe o valor médio;
**sum** - exibe a soma dos valores;
**count** - exibe a contagem de valores.
A agregação permite exibir um valor agregado para o intervalo (5 minutos, uma hora, um dia) selecionado na aba *Período de tempo* ou usado para todo o dashboard.|
|^|*Rótulo do conjunto de dados*|Especifique um rótulo personalizado para o conjunto de dados.
O rótulo é exibido na configuração do conjunto de dados e na legenda do gráfico de pizza (para conjuntos de dados agregados).
Todos os conjuntos de dados são numerados, inclusive aqueles com um *Rótulo do conjunto de dados* especificado. Se nenhum rótulo for especificado, o conjunto de dados será rotulado automaticamente de acordo com seu número (por exemplo, "Conjunto de dados #2", "Conjunto de dados #3", etc.). A numeração dos conjuntos de dados é recalculada após reordenar/arrastar os conjuntos de dados.
Rótulos de conjunto de dados muito longos serão encurtados para caber no local em que forem exibidos (por exemplo, "Número de proc...").|
|^|*Tags do item*|Especifique tags para filtrar os itens exibidos no widget.
É possível incluir e também excluir tags e valores de tag específicos. Várias condições podem ser definidas.
A correspondência do nome da tag é sempre sensível a maiúsculas e minúsculas.
Há vários operadores disponíveis para cada condição:
**Exists** - inclui os nomes de tag especificados;
**Equals** - inclui os nomes e valores de tag especificados (sensível a maiúsculas e minúsculas);
**Contains** - inclui os nomes de tag especificados cujos valores de tag contenham a string informada (correspondência de substring, sem distinção entre maiúsculas e minúsculas);
**Does not exist** - exclui os nomes de tag especificados;
**Does not equal** - exclui os nomes e valores de tag especificados (sensível a maiúsculas e minúsculas);
**Does not contain** - exclui os nomes de tag especificados cujos valores de tag contenham a string informada (correspondência de substring, sem distinção entre maiúsculas e minúsculas).
Há dois tipos de cálculo para as condições:
**And/Or** - todas as condições devem ser atendidas, as condições que tiverem o mesmo nome de tag serão agrupadas pela condição Or;
**Or** - basta que uma condição seja atendida.|
[comment]: # ({/3ecdd5a0-013fdb30})
[comment]: # ({a41ba8f1-b4dbf802})
##### Detalhes da configuração do conjunto de dados
Os conjuntos de dados existentes são exibidos em uma lista.
Você pode reorganizar, expandir/recolher, alterar cores e clonar esses conjuntos de dados.
Para mais informações, consulte detalhes da configuração do conjunto de dados no widget [*Gráfico*](/manual/web_interface/frontend_sections/dashboards/widgets/graph#data-set-configuration-details).
Esses detalhes também se aplicam ao widget *Gráfico de pizza*.
[comment]: # ({/a41ba8f1-b4dbf802})
[comment]: # ({32fe8c19-1febaa4b})
#### Opções de exibição
A aba **Opções de exibição** permite definir as opções de seleção de dados do histórico e de visualização para o gráfico de pizza:
{width="600"}
| | | | |
|-|-|----------|----------------------------------------|
|*Seleção de dados do histórico*|<|<|Selecione a fonte de dados:
**Auto** - os dados são obtidos de acordo com o [algoritmo](/manual/config/visualization/graphs/simple#generating-from-historytrends) clássico (padrão);
**Histórico** - dados do histórico;
**Tendências** - dados de tendências.|
|*Desenhar*|<|<|Selecione o estilo de visualização do gráfico de pizza:
**Pizza** - uma pizza completa (os setores ocupam 100% do raio);
**Rosca** - uma pizza com um círculo vazio no meio (os setores usam até 50% do raio).|
|*Espaço entre setores*|<|<|Selecione o tamanho do espaço (em unidades de 0 a 10) entre os setores (o padrão é "1").|
|*Mesclar setores menores que N%*|<|<|Marque a caixa de seleção para mesclar setores menores que N%.
Se habilitado, selecione a cor dos setores mesclados e o limite percentual (N) para mesclar setores pequenos.|
|*Estilo de desenho: **Rosca*** |<|<|<|
| |*Largura*|<|Selecione a largura da rosca: 20, 30, 40 ou 50% (padrão) do raio.|
|^|*Largura da borda*|<|Selecione a largura da borda do setor da rosca (0-10).|
|^|*Mostrar valor total*|<|Marque a caixa de seleção para mostrar o valor total no meio do gráfico de rosca.|
|^| |*Tamanho*|Selecione a opção de tamanho para o valor total:
**Auto** - o tamanho do texto é ajustado automaticamente para caber de forma legível no centro da rosca;
**Personalizado** - especifique o tamanho do texto como porcentagem da altura total do widget.|
|^|^|*Casas decimais*|Especifique o número de casas decimais para o valor total (0-6).|
|^|^|*Unidades*|Especifique as unidades para o valor total.|
|^|^|*Negrito*|Marque a caixa de seleção para exibir o valor total em negrito.|
|^|^|*Cor*|Selecione a cor do valor total.|
[comment]: # ({/32fe8c19-1febaa4b})
[comment]: # ({9e8618e7-dbd84beb})
#### Período de tempo
A aba **Período de tempo** permite definir um período de tempo personalizado para as configurações de agregação do gráfico de pizza:
{width="600"}
| | |
|--|--------|
|*Período de tempo*|Selecione a [fonte de dados](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) para o período de tempo:
**Dashboard** - usa o [seletor de período de tempo](/manual/web_interface/time_period_selector) do dashboard;
**Widget** - usa um widget compatível (definido no parâmetro *Widget*);
**Personalizado** - usa um período de tempo personalizado especificado nos parâmetros *De* e *Até*; se definido, um ícone de relógio será exibido no canto superior direito do widget, indicando o tempo definido ao passar o mouse.
Observe que, independentemente da configuração de *Período de tempo* do widget, widgets compatíveis ainda podem usá-lo como fonte de dados para o período de tempo.|
|*Widget*|Digite ou selecione um widget compatível (*Gráfico*, *Gráfico (clássico)*, *Protótipo de gráfico*) como fonte de dados para o período de tempo.
Este parâmetro está disponível se *Período de tempo* estiver definido como "Widget".|
|*De*|Digite ou selecione o início do período de tempo.
A [sintaxe de tempo relativo](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) é suportada.
Este parâmetro está disponível se *Período de tempo* estiver definido como "Personalizado".|
|*Até*|Digite ou selecione o final do período de tempo.
A [sintaxe de tempo relativo](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) é suportada.
Este parâmetro está disponível se *Período de tempo* estiver definido como "Personalizado".|
[comment]: # ({/9e8618e7-dbd84beb})
[comment]: # ({dae145c8-5d3f87b1})
#### Legenda
A aba **Legenda** permite personalizar a legenda do gráfico de pizza:
{width="600"}
| | |
|--|--------|
|*Exibir legenda*|Desmarque esta caixa para ocultar a legenda no gráfico de pizza (marcada por padrão).|
|*Exibir valor*|Marque esta caixa para exibir o valor do item na legenda.|
|*Exibir função de agregação*|Marque esta caixa para exibir a função de agregação na legenda.|
|*Linhas*|Selecione o modo de exibição para as linhas da legenda:
**Fixo** - o número de linhas exibidas é determinado pelo valor do parâmetro *Número de linhas*;
**Variável** - o número de linhas exibidas é determinado pela quantidade de items configurados, sem exceder o valor do parâmetro *Número máximo de linhas*.|
|*Número de linhas/*
*Número máximo de linhas*|Se *Linhas* estiver definido como "Fixo", defina o número de linhas da legenda a serem exibidas (1-10).
Se *Linhas* estiver definido como "Variável", defina o número máximo de linhas da legenda a serem exibidas (1-10).|
|*Número de colunas*|Defina o número de colunas da legenda a serem exibidas (1-4).
Este parâmetro está disponível se *Exibir valor* estiver desmarcado.|
[comment]: # ({/dae145c8-5d3f87b1})