[comment]: # aside: 1

[comment]: # ({b839f372-d8014f4f})
# Objeto settings

Os seguintes objetos estão diretamente relacionados à API `settings`.

[comment]: # ({/b839f372-d8014f4f})

[comment]: # ({1ba972b7-a08f9118})
### Configurações

O objeto settings possui as seguintes propriedades.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|default\_lang|string|Idioma do sistema por padrão.<br><br>Default: `en_US`.|
|default\_timezone|string|Fuso horário do sistema por padrão.<br><br>Default: `system` - padrão do sistema.<br><br>Para a lista completa de fusos horários suportados, consulte a [documentação do PHP](https://www.php.net/manual/en/timezones.php).|
|default\_theme|string|Tema padrão.<br><br>Valores possíveis:<br>`blue-theme` - *(padrão)* Azul;<br>`dark-theme` - Escuro;<br>`hc-light` - Alto contraste claro;<br>`hc-dark` - Alto contraste escuro.|
|search\_limit|integer|Limite para resultados de pesquisa e filtro.<br><br>Default: 1000.|
|max\_overview\_table\_size|integer|Número máximo de colunas e linhas nos widgets do painel Data overview e Trigger overview.<br><br>Default: 50.|
|max\_in\_table|integer|Quantidade máxima de elementos a exibir dentro da célula da tabela.<br><br>Default: 50.|
|server\_check\_interval|integer|Exibir aviso se o Zabbix server estiver indisponível.<br><br>Valores possíveis:<br>0 - Não exibir aviso;<br>10 - *(padrão)* Exibir aviso.|
|work\_period|string|Horário de trabalho.<br><br>Default: 1-5,09:00-18:00.|
|show\_technical\_errors|integer|Exibir erros técnicos (PHP/SQL) para usuários que não sejam Super admin e para usuários que não pertençam a grupos de usuários com o modo de depuração habilitado.<br><br>Valores possíveis:<br>0 - *(padrão)* Não exibir erros técnicos;<br>1 - Exibir erros técnicos.|
|history\_period|string|Período máximo para exibir dados de histórico nos widgets Latest data, Web e Data overview do painel.<br>Aceita segundos e unidade de tempo com sufixo.<br><br>Default: 24h.|
|period\_default|string|Período padrão do filtro de tempo.<br>Aceita segundos e unidade de tempo com sufixo, com suporte a mês e ano (30s, 1m, 2h, 1d, 1M, 1y).<br><br>Default: 1h.|
|max\_period|string|Período máximo para o filtro de tempo.<br>Aceita segundos e unidade de tempo com sufixo, com suporte a mês e ano (30s, 1m, 2h, 1d, 1M, 1y).<br><br>Default: 2y.|
|severity\_color\_0|string|Cor para a severidade "Not classified" como código de cor hexadecimal.<br><br>Default: 97AAB3.|
|severity\_color\_1|string|Cor para a severidade "Information" como código de cor hexadecimal.<br><br>Default: 7499FF.|
|severity\_color\_2|string|Cor para a severidade "Warning" como código de cor hexadecimal.<br><br>Default: FFC859.|
|severity\_color\_3|string|Cor para a severidade "Average" como código de cor hexadecimal.<br><br>Default: FFA059.|
|severity\_color\_4|string|Cor para a severidade "High" como código de cor hexadecimal.<br><br>Default: E97659.|
|severity\_color\_5|string|Cor para a severidade "Disaster" como código de cor hexadecimal.<br><br>Default: E45959.|
|severity\_name\_0|string|Nome para a severidade "Not classified".<br><br>Default: Not classified.|
|severity\_name\_1|string|Nome para a severidade "Information".<br><br>Default: Information.|
|severity\_name\_2|string|Nome para a severidade "Warning".<br><br>Default: Warning.|
|severity\_name\_3|string|Nome para a severidade "Average".<br><br>Default: Average.|
|severity\_name\_4|string|Nome para a severidade "High".<br><br>Default: High.|
|severity\_name\_5|string|Nome para a severidade "Disaster".<br><br>Default: Disaster.|
|custom\_color|integer|Usar cores personalizadas para o status dos eventos.<br><br>Valores possíveis:<br>0 - *(padrão)* Não usar cores personalizadas para o status dos eventos;<br>1 - Usar cores personalizadas para o status dos eventos.|
|ok\_period|string|Exibir período de triggers OK.<br>Aceita segundos e unidade de tempo com sufixo.<br><br>Default: 5m.|
|blink\_period|string|Ao alterar o status, período de piscar das triggers.<br>Aceita segundos e unidade de tempo com sufixo.<br><br>Default: 2m.|
|problem\_unack\_color|string|Cor para eventos PROBLEM não reconhecidos como código de cor hexadecimal.<br><br>Default: CC0000.|
|problem\_ack\_color|string|Cor para eventos PROBLEM reconhecidos como código de cor hexadecimal.<br><br>Default: CC0000.|
|ok\_unack\_color|string|Cor para eventos RESOLVED não reconhecidos como código de cor hexadecimal.<br><br>Default: 009900.|
|ok\_ack\_color|string|Cor para eventos RESOLVED reconhecidos como código de cor hexadecimal.<br><br>Default: 009900.|
|problem\_unack\_style|integer|Piscar para eventos PROBLEM não reconhecidos.<br><br>Valores possíveis:<br>0 - Não exibir piscar;<br>1 - *(padrão)* Exibir piscar.|
|problem\_ack\_style|integer|Piscar para eventos PROBLEM reconhecidos.<br><br>Valores possíveis:<br>0 - Não exibir piscar;<br>1 - *(padrão)* Exibir piscar.|
|ok\_unack\_style|integer|Piscar para eventos RESOLVED não reconhecidos.<br><br>Valores possíveis:<br>0 - Não exibir piscar;<br>1 - *(padrão)* Exibir piscar.|
|ok\_ack\_style|integer|Piscar para eventos RESOLVED reconhecidos.<br><br>Valores possíveis:<br>0 - Não exibir piscar;<br>1 - *(padrão)* Exibir piscar.|
|url|string|URL do frontend.|
|discovery\_groupid|ID|ID do grupo de hosts ao qual os hosts descobertos serão automaticamente atribuídos.|
|default\_inventory\_mode|integer|Modo padrão do inventário do host.<br><br>Valores possíveis:<br>-1 - *(padrão)* Desativado;<br>0 - Manual;<br>1 - Automático.|
|alert\_usrgrpid|ID|ID do grupo de usuários para o qual a mensagem de alarme de indisponibilidade do banco de dados será enviada.<br><br>Se definido como "0", a mensagem de alarme não será enviada.|
|snmptrap\_logging|integer|Registrar traps SNMP não correspondentes.<br><br>Valores possíveis:<br>0 - Não registrar traps SNMP não correspondentes;<br>1 - *(padrão)* Registrar traps SNMP não correspondentes.|
|login\_attempts|integer|Número de tentativas de login com falha após o qual o formulário de login será bloqueado.<br><br>Default: 5.|
|login\_block|string|Intervalo de tempo durante o qual o formulário de login será bloqueado se o número de tentativas de login com falha exceder o definido no campo login\_attempts.<br>Aceita segundos e unidade de tempo com sufixo.<br><br>Default: 30s.|
|validate\_uri\_schemes|integer|Validar esquemas de URI.<br><br>Valores possíveis:<br>0 - Não validar;<br>1 - *(padrão)* Validar.|
|uri\_valid\_schemes|string|Esquemas de URI válidos.<br><br>Default: http,https,ftp,file,mailto,tel,ssh.|
|x\_frame\_options|string|Cabeçalho HTTP X-Frame-Options.<br><br>Default: SAMEORIGIN.|
|iframe\_sandboxing\_enabled|integer|Usar sandboxing de iframe.<br><br>Valores possíveis:<br>0 - Não usar;<br>1 - *(padrão)* Usar.|
|iframe\_sandboxing\_exceptions|string|Exceções de sandboxing de iframe.|
|connect\_timeout|string|Tempo limite de conexão com o Zabbix server.<br><br>Intervalo de valores possíveis: 1-30s.<br><br>Default: 3s.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|socket\_timeout|string|Tempo limite padrão da rede.<br><br>Intervalo de valores possíveis: 1-300s.<br><br>Default: 3s.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|media\_type\_test\_timeout|string|Tempo limite de rede para teste de media type.<br><br>Intervalo de valores possíveis: 1-300s.<br><br>Default: 65s.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|item\_test\_timeout|string|Tempo limite de rede para testes de item.<br><br>Intervalo de valores possíveis: 1-600s.<br><br>Default: 60s.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|script\_timeout|string|Tempo limite de rede para execução de script.<br><br>Intervalo de valores possíveis: 1-300s.<br><br>Default: 60s.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|report\_test\_timeout|string|Tempo limite de rede para teste de relatório agendado.<br><br>Intervalo de valores possíveis: 1-300s.<br><br>Default: 60s.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|auditlog\_enabled|integer|Indica se o registro de auditoria deve ser habilitado.<br><br>Valores possíveis:<br>0 - Desativar;<br>1 - *(padrão)* Ativar.|
|auditlog\_mode|integer|Indica se o registro de auditoria de atividades de low-level discovery, network discovery e autoregistration executadas pelo server (usuário System) deve ser habilitado.<br><br>Valores possíveis:<br>0 - Desativar;<br>1 - *(padrão)* Ativar.|
|ha\_failover\_delay|string|Atraso de failover em segundos.<br><br>Default: 1m.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|geomaps\_tile\_provider|string|Provedor de tiles do geomap.<br><br>Valores possíveis:<br>`OpenStreetMap.Mapnik` - *(padrão)* OpenStreetMap Mapnik;<br>`OpenTopoMap` - OpenTopoMap;<br>`Stamen.TonerLite` - Stamen Toner Lite;<br>`Stamen.Terrain` - Stamen Terrain;<br>`USGS.USTopo` - USGS US Topo;<br>`USGS.USImagery` - USGS US Imagery.<br><br>Suporta string vazia para especificar valores personalizados de `geomaps_tile_url`, `geomaps_max_zoom` e `geomaps_attribution`.|
|geomaps\_tile\_url|string|URL do tile do geomap.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `geomaps_tile_provider` is set to empty string|
|geomaps\_max\_zoom|integer|Nível máximo de zoom do geomap.<br><br>Valores possíveis: 0-30.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `geomaps_tile_provider` is set to empty string|
|geomaps\_attribution|string|Texto de atribuição do geomap.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `geomaps_tile_provider` is set to empty string|
|vault\_provider|integer|Provedor de vault.<br><br>Valores possíveis:<br>0 - *(padrão)* HashiCorp Vault;<br>1 - CyberArk Vault.|
|timeout\_zabbix\_agent|string|Gaste no máximo `timeout_*` segundos no processamento.<br>Aceita segundos ou unidade de tempo com sufixo (por exemplo, 30s, 1m). Também aceita macros de usuário.<br><br>Intervalo de valores possíveis: 1-600s.<br><br>Default: 3s.<br>Default for `timeout_browser`: 60s.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|timeout\_simple\_check|^|^|
|timeout\_snmp\_agent|^|^|
|timeout\_external\_check|^|^|
|timeout\_db\_monitor|^|^|
|timeout\_http\_agent|^|^|
|timeout\_ssh\_agent|^|^|
|timeout\_telnet\_agent|^|^|
|timeout\_script|^|^|
|timeout\_browser|^|^|

[comment]: # ({/1ba972b7-a08f9118})
