[comment]: # ({856c911b-856c911b})
# 1 Formato da chave do item

O formato da chave do item, incluindo os parâmetros da chave, deve seguir as regras de sintaxe.
As ilustrações a seguir mostram a sintaxe suportada. Os elementos e caracteres permitidos em cada ponto podem ser determinados seguindo as setas - se algum bloco puder ser alcançado pela linha, ele é permitido, caso contrário, não é permitido.

![](../../../../../assets/en/manual/config/item_key_2.png){width="600"}

Para construir uma chave de item válida, começa-se especificando o nome da chave, depois há a escolha de ter ou não parâmetros - conforme mostrado pelas duas linhas que podem ser seguidas.

[comment]: # ({/856c911b-856c911b})

[comment]: # ({63ccf8e4-63ccf8e4})
#### Nome da chave

O próprio nome da chave possui um intervalo limitado de caracteres permitidos, que
simplesmente seguem uns aos outros. Os caracteres permitidos são:

    0-9a-zA-Z_-.

O que significa:

-   todos os números;
-   todas as letras minúsculas;
-   todas as letras maiúsculas;
-   sublinhado;
-   traço;
-   ponto.

![](../../../../../assets/en/manual/config/key_name.png)

[comment]: # ({/63ccf8e4-63ccf8e4})

[comment]: # ({7262f26f-af5ae7f1})
#### Parâmetros de chave

Uma chave de item pode ter vários parâmetros separados por vírgulas.

![](../../../../../assets/pt/manual/config/key_parameters.png)

Cada parâmetro de chave pode ser uma string entre aspas, uma string sem aspas ou um array.

![](../../../../../assets/pt/manual/config/item_parameter.png)

O parâmetro também pode ser deixado em branco, usando assim o valor padrão. Nesse caso, o número apropriado de vírgulas deve ser adicionado se quaisquer outros parâmetros forem especificados. Por exemplo, a chave de item **icmpping\[,,200,,500\]** especificaria que o intervalo entre pings individuais é de 200 milissegundos, o tempo limite - 500 milissegundos, e todos os outros parâmetros permanecem com seus valores padrão.

É possível incluir macros nos parâmetros. Elas podem ser [macros de usuário](/manual/appendix/macros/supported_by_location_user#items-item-prototypes) ou algumas das macros internas.
Para ver quais macros internas específicas são suportadas nos parâmetros de chave de item,
procure na página [Macros suportadas](/manual/appendix/macros/supported_by_location) por "item key parameters".

[comment]: # ({/7262f26f-af5ae7f1})

[comment]: # ({816c672d-b4a70ec9})
#### Parâmetro - string entre aspas

Se o parâmetro da chave for uma string entre aspas, qualquer caractere Unicode é permitido. Se a string do parâmetro da chave contiver uma aspa, esse parâmetro deverá ser colocado entre aspas e cada aspa que fizer parte da string do parâmetro deverá ser escapada com um caractere de barra invertida (`\`). Se a string do parâmetro da chave contiver vírgula, esse parâmetro deverá ser colocado entre aspas.

![](../../../../../assets/en/manual/config/key_param_quoted_string.png)

::: notewarning
Para colocar parâmetros de chave de item entre aspas, use apenas aspas duplas. Aspas simples não são suportadas.
:::

::: noteimportant
Arrays de parâmetros multinível, por exemplo, `[a,[b,[c,d]],e]`, não são permitidos.
:::

[comment]: # ({/816c672d-b4a70ec9})

[comment]: # ({3376836e-3376836e})
#### Parâmetro - string sem aspas

Se o parâmetro da chave for uma string sem aspas, qualquer caractere Unicode é permitido, exceto vírgula e colchete direito (\]). O parâmetro sem aspas não pode começar com colchete esquerdo (\[).

![](../../../../../assets/pt/manual/config/key_param_unquoted_string.png)

[comment]: # ({/3376836e-3376836e})

[comment]: # ({43e6bef7-5289a973})
#### Parâmetro - array

Se o parâmetro da chave for um array, ele será novamente colocado entre colchetes, onde os parâmetros individuais seguem as regras e sintaxe de especificação de múltiplos parâmetros.

![](../../../../../assets/en/manual/config/key_param_array.png)

[comment]: # ({/43e6bef7-5289a973})