[comment]: # translation:outdated
[comment]: # ({2224a200-e8992262})
# 8 Mappatura dei valori
[comment]: # ({/2224a200-e8992262})
[comment]: # ({cb8222c8-2d2da55e})
#### Panoramica
La mappatura dei valori consente di configurare una rappresentazione più intuitiva dei valori ricevuti utilizzando associazioni tra valori numerici/stringa e rappresentazioni testuali.
Ad esempio, quando il valore di un item è "0" o "1", le mappature dei valori possono essere utilizzate per rappresentare questi valori in modo più comprensibile:
- 0 → Non disponibile
- 1 → Disponibile
Le mappature dei valori per i tipi di backup dei dati potrebbero essere configurate come segue:
- F → Completo
- D → Differenziale
- I → Incrementale
Gli intervalli di valori per la tensione potrebbero essere configurati come segue:
- \<=209 → Bassa
- 210-230 → OK
- \>=231 → Alta
La mappatura dei valori viene utilizzata nel frontend di Zabbix e nelle notifiche inviate dai tipi di supporto.
::: noteimportant
La sostituzione del valore ricevuto con la rappresentazione configurata viene eseguita sia nel frontend di Zabbix sia nel server;
tuttavia, il server gestisce la sostituzione solo nei seguenti casi:
- durante il popolamento dell'[inventario host](/manual/config/hosts/inventory#inventory-overview);
- durante l'espansione delle [macro supportate](/manual/appendix/macros/supported_by_location) {ITEM.VALUE}, {ITEM.LASTVALUE}, {EVENT.OPDATA} e {EVENT.CAUSE.OPDATA}.
:::
Le mappature dei valori vengono impostate su template o host.
Una volta configurate, sono disponibili per tutti gli item all'interno del rispettivo template o host.
Quando si [configurano gli item](/manual/config/items/item#configuration), specificare il nome di una mappatura dei valori configurata in precedenza nel parametro *Value mapping*.
::: noteclassic
Non esiste ereditarietà delle mappe dei valori: host e template non ereditano le mappature dei valori dai template collegati.
Gli item del template su un host continueranno a utilizzare le mappature dei valori configurate sul template.
:::
::: noteclassic
Le mappature dei valori possono essere utilizzate con item che hanno tipi di informazione *Numeric (unsigned)*, *Numeric (float)* e *Character*.
:::
Le mappature dei valori vengono esportate/importate con il rispettivo template o host.
Possono anche essere aggiornate in massa utilizzando i moduli di aggiornamento di massa di [host](/manual/config/hosts/hostupdate) e [template](/manual/config/templates/mass).
[comment]: # ({/cb8222c8-2d2da55e})
[comment]: # ({158cd610-18d7ef55})
#### Configurazione
Per configurare una mappatura dei valori, segui questi passaggi:
1\. Apri il modulo di configurazione del host o del template.
2\. Nella scheda *Mappatura dei valori*, fai clic su *Aggiungi* per aggiungere una nuova mappatura dei valori, oppure fai clic sul nome di una mappatura esistente per modificarla.
Parametri di una mappatura dei valori:
|Parametro|<|Descrizione|
|-|----------|----------------------------------------|
|*Nome*|<|Nome univoco per l'insieme delle mappature dei valori.|
|*Mappature*|<|Regole individuali per mappare valori numerici/stringa in rappresentazioni testuali.
La mappatura viene applicata nell'ordine delle regole, che può essere modificato trascinandole.|
| |*Tipo*|Tipo di mappatura:
**uguale a** - i valori uguali verranno mappati;
**maggiore o uguale a** - i valori uguali o maggiori verranno mappati;
**minore o uguale a** - i valori uguali o minori verranno mappati;
**nell'intervallo** - i valori nell'intervallo verranno mappati; l'intervallo è espresso come - o ; sono supportati più intervalli (ad esempio, 1-10,101-110,201);
**regexp** - verranno mappati i valori corrispondenti alla [espressione regolare](/manual/regular_expressions) (le espressioni regolari globali non sono supportate);
**predefinito** - verranno mappati tutti i valori rimanenti, diversi da quelli con mappature specifiche.
Per la mappatura degli intervalli sono supportati solo i tipi di valore numerici (*maggiore o uguale a*, *minore o uguale a*, *nell'intervallo*).|
|^|*Valore*|Valore in ingresso (può contenere un intervallo o un'espressione regolare, a seconda del tipo di mappatura).|
|^|*Mappato a*|Rappresentazione testuale (fino a 64 caratteri) del valore in ingresso.|
Tutti i campi di input obbligatori sono contrassegnati da un asterisco rosso.
Quando si visualizza la mappatura dei valori nell'elenco, sono visibili solo le prime tre mappature; tre puntini indicano che esistono altre mappature.
[comment]: # ({/158cd610-18d7ef55})
[comment]: # ({74c7cb6d-6241051d})
#### Esempio di mappatura dei valori
Uno degli item predefiniti dell'agent, *Zabbix agent ping*, utilizza una mappatura dei valori a livello di template "Zabbix agent ping status" per visualizzare i propri valori.
Nel [modulo di configurazione](/manual/config/items/item#configuration) dell'item, puoi trovare un riferimento a questa mappatura dei valori nel campo *Value mapping*:
Questa mappatura viene utilizzata nella sezione *Monitoring* → *Latest data* per visualizzare "Up" (con il valore grezzo tra parentesi).
{width="600"}
::: noteclassic
Nella sezione *Latest data*, i valori visualizzati vengono abbreviati a 20 caratteri.
Se viene utilizzata la mappatura dei valori, questa abbreviazione non viene applicata al valore mappato ma solo al valore grezzo (visualizzato tra parentesi).
:::
Senza una mappatura dei valori predefinita, vedresti solo "1", che potrebbe essere difficile da comprendere.
{width="600"}
[comment]: # ({/74c7cb6d-6241051d})