[comment]: # translation:outdated [comment]: # ({50342b23-50342b23}) # 1 Tworzenie pozycji [comment]: # ({/50342b23-50342b23}) [comment]: # ({d3a04061-d3a04061}) #### Przegląd Aby utworzyć pozycję w interfejsie Zabbix, wykonaj następujące kroki: - Przejdź do: *Konfiguracja* → *Hosty* - Kliknij na *Pozycje* w wierszu hosta - Kliknij na *Utwórz pozycję* w prawym górnym rogu ekranu - Wprowadź parametry pozycji w formularzu Możesz również utworzyć pozycję, otwierając istniejącą, naciskając przycisk *Powiel*, a następnie zapisując pod inną nazwą. [comment]: # ({/d3a04061-d3a04061}) [comment]: # ({d70f2a42-d0a0a311}) #### Konfiguracja Zakładka **Pozycja** zawiera ogólne atrybuty pozycji. ![](../../../../assets/en/manual/config/items/item.png) Wszystkie obowiązkowe pola wejściowe są oznaczone czerwoną gwiazdką. |Parametr|Opis| |--|--------| |*Nazwa*|Nazwa pozycji.| |*Typ*|Typ pozycji. Zobacz poszczególne sekcje [typu pozycji](itemtypes).| |*Klucz*|Klucz pozycji (do 2048 znaków).
Obsługiwane [klucze pozycji](itemtypes) można znaleźć w poszczególnych sekcjach typów pozycji.
Klucz musi być unikalny w obrębie jednego hosta.
Jeśli typ klucza to 'Agent Zabbix', 'Agent Zabbix (aktywny)' lub 'Proste sprawdzenie', wartość klucza musi być obsługiwana przez agenta Zabbix lub serwer Zabbix.
Zobacz także: prawidłowy [format klucza](/manual/config/items/item/key).| |*Typ informacji*|Typ danych przechowywanych w bazie danych po wykonaniu konwersji, jeśli jest taka potrzeba.
**Liczba (całkowita bez znaku)** - liczba całkowita 64-bitowa bez znaku
**Liczba (zmiennoprzecinkowa)** - liczba zmiennoprzecinkowa 64-bitowa
Ten typ pozwoli na precyzję około 15 cyfr i zakres od około -1.79E+308 do 1.79E+308 (z wyjątkiem [PostgreSQL 11 i starszych wersji](/manual/installation/known_issues#numeric-float-data-type-range-with-postgresql-11-and-earlier)).
Odbieranie wartości w notacji naukowej jest również obsługiwane. Na przykład, 1.23E+7, 1e308, 1.1E-4.
**Znak** - krótkie teksty
**Log** - długie teksty z opcjonalnymi właściwościami dziennika (znacznik czasu, źródło, poziom, id zdarzenia dziennika)
**Tekst** - długie teksty. Zobacz także [limity danych tekstowych](#text-data-limits).
Dla kluczy pozycji, które zwracają dane tylko w jednym określonym formacie, automatycznie wybierany jest pasujący typ informacji.| |*Interfejs hosta*|Wybierz interfejs hosta. To pole jest dostępne podczas edycji pozycji na poziomie hosta.| |*Jednostki*|Jeśli ustawiony jest symbol jednostki, Zabbix doda przetwarzanie końcowe do otrzymanej wartości i wyświetli ją z ustawionym sufiksem jednostki.
Domyślnie, jeśli otrzymana wartość przekracza 1000, jest ona dzielona przez 1000 i odpowiednio wyświetlana. Na przykład, jeśli ustawisz *bps* i otrzymasz wartość 881764, zostanie wyświetlona jako 881.76 Kbps.
Standard pamięci [JEDEC](https://en.wikipedia.org/wiki/JEDEC_memory_standards) jest używany do przetwarzania jednostek **B** (bajt), **Bps** (bajty na sekundę), które są dzielone przez 1024. Dlatego, jeśli jednostki są ustawione na **B** lub **Bps**, Zabbix wyświetli:
1 jako 1B/1Bps
1024 jako 1KB/1KBps
1536 jako 1.5KB/1.5KBps
Specjalne przetwarzanie jest używane, jeśli używane są następujące jednostki związane z czasem:
**unixtime** - przetłumaczony na "yyyy.mm.dd hh:mm:ss". Aby przetłumaczyć poprawnie, otrzymana wartość musi być typu *Liczba (całkowita bez znaku)*.
**uptime** - przetłumaczony na "hh:mm:ss" lub "N dni, hh:mm:ss"
Na przykład, jeśli otrzymasz wartość jako 881764 (sekundy), zostanie wyświetlona jako "10 dni, 04:56:04"
**s** - przetłumaczony na "yyy mmm ddd hhh mmm sss ms"; parametr jest traktowany jako liczba sekund.
Na przykład, jeśli otrzymasz wartość jako 881764 (sekundy), zostanie wyświetlona jako "10d 4g 56m"
Wyświetlane są tylko 3 górne jednostki główne, jak "1m 15d 5g" lub "2g 4m 46s". Jeśli nie ma dni do wyświetlenia, wyświetlane są tylko dwie warstwy - "1m 5g" (nie pokazują minuty, sekundy ani milisekundy). Zostanie przetłumaczony na "< 1 ms", jeśli wartość jest mniejsza niż 0.001.
*Uwaga*, jeśli jednostka jest poprzedzona `!`, wówczas nie są stosowane prefiksy jednostek/przetwarzanie dla wartości pozycji. Zobacz [konwersję jednostek](#unit_conversion).| |*Interwał aktualizacji*|Pobierz nową wartość dla tej pozycji co N sekund. Maksymalny dozwolony interwał aktualizacji wynosi 86400 sekund (1 dzień).
Są obsługiwane [przyrostki czasu](/manual/appendix/suffixes), np. 30s, 1m, 2g, 1d.
Obsługiwane są [makra użytkownika](/manual/config/macros/user_macros).
Jedno makro musi wypełniać całe pole. Wiele makr w polu lub makra mieszane z tekstem nie są obsługiwane.
*Uwaga*: Interwał aktualizacji może być ustawiony na '0' tylko wtedy, gdy istnieją niestandardowe interwały o wartości różnej od zera. Jeśli ustawiony jest na '0', a istnieje okres użytkownika (elastyczny lub Harmonogramowanie) o wartości różnej od zera, pozycja będzie sprawdzana podczas trwania niestandardowego interwału.
*Uwaga*: Pierwsze sprawdzenie pozycji po jej aktywacji lub po zmianie interwału aktualizacji może wystąpić wcześniej niż skonfigurowana wartość.
Istniejąca pasywna pozycja może być natychmiast sprawdzana pod kątem wartości przez naciśnięcie [przycisku](#form_buttons) *Wykonaj teraz*.| |*Okresy użytkownika*|Możesz tworzyć niestandardowe reguły dla sprawdzania pozycji:
**Elastyczny** - tworzenie wyjątku dla *Interwału aktualizacji* (interwał o innej częstotliwości)
**Harmonogramowanie** - tworzenie niestandardowego harmonogramu sprawdzania.
Aby uzyskać szczegółowe informacje, zobacz [Okresy użytkownika](/manual/config/items/item/custom_intervals).
Są obsługiwane [przyrostki czasu](/manual/appendix/suffixes) w polu *Interwał*, np. 30s, 1m, 2g, 1d.
Obsługiwane są [makra użytkownika](/manual/config/macros/user_macros).
Jedno makro musi wypełniać całe pole. Wiele makr w polu lub makra mieszane z tekstem nie są obsługiwane.
Harmonogramowanie jest obsługiwane od Zabbix 3.0.0.
*Uwaga*: niestandardowe interwały dla aktywnych sprawdzeń są obsługiwane tylko przez agenta Zabbix 2.| |*Historia*|Wybierz jedną z opcji:
**Nie przechowuj historii** - historia pozycji nie jest przechowywana. Przydatne dla pozycji głównych, jeśli tylko pozycje zależne muszą przechowywać historię.
To ustawienie nie może być zastąpione przez globalne ustawienia [porządkowania](/manual/web_interface/frontend_sections/administration/general#housekeeper).
**Okres przechowywania** - określ czas przechowywania szczegółowej historii w bazie danych (od 1 godziny do 25 lat). Starsze dane będą usuwane przez porządkowanie. Przechowywane w sekundach.
Są obsługiwane [przyrostki czasu](/manual/appendix/suffixes), np. 2g, 1d. [Makra użytkownika](/manual/config/macros/user_macros) są obsługiwane.
Wartość *Okresu przechowywania* może być nadpisana globalnie w *Administracja → Ogólne → [Porządkowanie](/manual/web_interface/frontend_sections/administration/general#housekeeper)*.
Jeśli istnieje globalne ustawienie nadpisujące, wyświetlana jest zielona ![](../../../../assets/en/manual/config/info.png) ikona informacji. Jeśli najedziesz na nią kursorem, wyświetli się komunikat ostrzegawczy, np. *Nadpisane przez globalne ustawienia porządkowania (1d)*.
Zaleca się przechowywanie zapisanych wartości przez jak najkrótszy czas, aby zmniejszyć rozmiar historii wartości w bazie danych. Zamiast przechowywać długą historię wartości, można przechowywać dłużej dane trendów.
Zobacz także [Historia i trendy](/manual/config/items/history_and_trends).| |*Okres przechowywania trendów*|Wybierz jedną z opcji:
**Nie przechowuj trendów** - trendy nie są przechowywane.
To ustawienie nie może być zastąpione przez globalne ustawienia [porządkowania](/manual/web_interface/frontend_sections/administration/general#housekeeper).
**Okres przechowywania** - określ czas przechowywania skumulowanej historii (godzinny minimum, maksimum, średnia, ilość) w bazie danych (od 1 dnia do 25 lat). Starsze dane będą usuwane przez porządkowanie. Przechowywane w sekundach.
Są obsługiwane [przyrostki czasu](/manual/appendix/suffixes), np. 24g, 1d. [Makra użytkownika](/manual/config/macros/user_macros) są obsługiwane.
Wartość *Okresu przechowywania* może być nadpisana globalnie w *Administracja → Ogólne → [Porządkowanie](/manual/web_interface/frontend_sections/administration/general#housekeeper)*.
Jeśli istnieje globalne ustawienie nadpisujące, wyświetlana jest zielona ![](../../../../assets/en/manual/config/info.png) ikona informacji. Jeśli najedziesz na nią kursorem, wyświetli się komunikat ostrzegawczy, np. *Nadpisane przez globalne ustawienia porządkowania (7d)*.
*Uwaga:* Przechowywanie trendów nie jest dostępne dla danych nie-liczbowych - znak, log i tekst.
Zobacz także [Historia i trendy](/manual/config/items/history_and_trends).| |*Mapowanie wartości*|Zastosuj mapowanie wartości do tej pozycji. [Mapowanie wartości](/manual/config/items/mapping) nie zmienia otrzymywanych wartości, służy tylko do wyświetlania danych.
Działa z pozycjami *Liczba (całkowita bez znaku)*, *Liczba (zmiennoprzecinkowa)* oraz *Znak*.
Np. "Stany usług systemu Windows".| |*Format czasu dla logowania*|Dostępny tylko dla pozycji typu **Log**. Obsługiwane symbole zastępcze:
\* **y**: *Rok (1970-2038)*
\* **M**: *Miesiąc (01-12)*
\* **d**: *Dzień (01-31)*
\* **h**: *Godzina (00-23)*
\* **m**: *Minuta (00-59)*
\* **s**: *Sekunda (00-59)*
Jeśli pole jest puste, znacznik czasowy nie będzie parsowany.
Np. rozważmy następującą linię z pliku dziennika agenta Zabbix:
" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."
Zaczyna się od sześciu pozycji znakowych dla PID, a następnie daty, czasu i reszty linii.
Format czasu dziennika dla tej linii to "pppppp:yyyyMMdd:hhmmss".
Zauważ, że znaki "p" i ":" to tylko symbole zastępcze i mogą być czymkolwiek innym niż "yMdhms".| |*Powielaj pola inwentarza hosta*|Możesz wybrać pole inwentarza hosta, które zostanie wypełnione wartością pozycji. To zadziała, jeśli [inwentaryzacja](/manual/config/hosts/inventory) automatyczne jest włączona dla hosta.
To pole nie jest dostępne, jeśli *Typ informacji* jest ustawiony na 'Log'.| |*Opis*|Wprowadź opis pozycji. Obsługiwane są [makra użytkownika](/manual/config/macros/user_macros).| |*Włączony*|Zaznacz pole wyboru, aby włączyć pozycję, dzięki czemu zostanie przetwarzana.| |*Najnowsze dane*|Kliknij na link, aby zobaczyć najnowsze dane dotyczące pozycji.
Ten link jest dostępny tylko podczas edycji już istniejącej pozycji.| ::: noteclassic Specyficzne dla typu pozycji pola opisane są na [odpowiadających stronach](itemtypes). ::: ::: noteclassic Podczas edycji istniejącej pozycji z [szablonu](/manual/config/templates) na poziomie hosta, wiele pól jest tylko do odczytu. Możesz użyć linku w nagłówku formularza i przejść do poziomu szablonu, aby edytować je tam, pamiętając, że zmiany na poziomie szablonu zmienią pozycję dla wszystkich hostów, do których szablon jest podłączony. ::: Zakładka **Znaczniki** pozwala zdefiniować [tagi](/manual/config/tagging) na poziomie pozycji. ![](../../../../assets/en/manual/config/items/item_b.png) [comment]: # ({/d70f2a42-d0a0a311}) [comment]: # ({4f9077b8-4f9077b8}) ##### Przetwarzanie wstępne wartości pozycji Zakładka **Przetwarzanie wstępne** pozwala zdefiniować [reguły transformacji](/manual/config/items/preprocessing) dla otrzymywanych wartości. [comment]: # ({/4f9077b8-4f9077b8}) [comment]: # ({ff2c0878-006c45ea}) #### Testowanie ::: noteimportant Aby przeprowadzić test pozycji, upewnij się, że czas systemowy na serwerze i w proxy jest [zsynchronizowany](/manual/installation/requirements#time-synchronization). W przypadku gdy czas na serwerze jest opóźniony, testowanie pozycji może zwrócić komunikat o błędzie "Zadanie wygasło". Ustawienie różnych stref czasowych na serwerze i w proxy nie wpłynie jednak na wynik testu. ::: Możliwe jest przetestowanie pozycji i, jeśli skonfigurowano ją poprawnie, otrzymanie rzeczywistej wartości. Testowanie może nastąpić nawet przed zapisaniem pozycji. Testowanie jest dostępne dla pozycji hosta i szablonów, prototypów pozycji oraz reguł wykrywania niskopoziomowego. Testowanie nie jest dostępne dla pozycji aktywnych. Testowanie pozycji jest dostępne dla następujących pasywnych typów pozycji: - Agent Zabbix - Agent SNMP (v1, v2, v3) - Agent IPMI - Agent SSH - Agent Telnet - Agent JMX - Proste sprawdzenie (za wyjątkiem pozycji `icmpping*`, `vmware.*`) - Wewnętrzny Zabbix - Obliczona - Test zewnętrzny - Monitor bazy danych - Agent HTTP - Skrypt Aby przetestować pozycję, kliknij przycisk *Testuj* na dole formularza konfiguracji pozycji. Zauważ, że przycisk *Testuj* będzie wyłączony dla pozycji, które nie mogą być testowane (takich jak sprawdzenia aktywne, wyłączone proste sprawdzenia). ![](../../../../assets/en/manual/config/items/item_test_button.png) Formularz testowania pozycji ma pola dla wymaganych parametrów hosta (adres hosta, port, nazwa proxy/brak proxy) oraz szczegóły specyficzne dla pozycji (takie jak hałso SNMPv2 lub poświadczenia bezpieczeństwa SNMPv3). Te pola mają znajomość kontekstu: - Wartości są wstępnie wypełniane, jeśli to możliwe, tj. dla pozycji wymagających agenta, poprzez pobranie informacji z wybranej interfejsu agenta hosta - Wartości muszą być wprowadzone ręcznie dla pozycji szablonów - Wartości makr w formie zwykłego tekstu są rozwiązywane - Pola, w których wartość (lub część wartości) jest tajna lub jako sekret Vault, są puste i muszą być wprowadzone ręcznie. Jeśli którykolwiek parametr pozycji zawiera wartość makra tajnego, wyświetlany jest następujący komunikat ostrzegawczy: "Pozycja zawiera makra użytkownika z sekretnymi wartościami. Wartości takich makr powinny być wpisywane ręcznie." - Pola są wyłączone, gdy nie są potrzebne w kontekście typu pozycji (np. pole adresu hosta i pole proxy są wyłączone dla pozycji obliczanych) Aby przetestować pozycję, kliknij *Pobierz wartość*. Jeśli wartość zostanie pomyślnie pobrana, wypełni pole *Wartość*, przenosząc bieżącą wartość (jeśli istnieje) do pola *Poprzednia wartość*, obliczając jednocześnie pole *Czas poprzedni*, tj. różnicę czasu między dwoma wartościami (kliknięciami), a także próbując wykryć sekwencję EOL i przełączyć na CRLF w przypadku wykrycia " \\ n \\ r" w pobranej wartości. ![](../../../../assets/en/manual/config/items/item_test.png){width="600"} Jeśli konfiguracja jest niepoprawna, wyświetlany jest komunikat o błędzie opisujący możliwą przyczynę. ![](../../../../assets/en/manual/config/items/item_test_error.png) Pomyślnie pobrana wartość z hosta może również być użyta do przetestowania [kroków przetwarzania wstępnego](/manual/config/items/preprocessing#testing). [comment]: # ({/ff2c0878-006c45ea}) [comment]: # ({961d04fe-4b126a62}) #### Przyciski formularza Przyciski na dole formularza pozwalają na wykonanie kilku operacji. | | | |--|--------| |![](../../../../assets/en/manual/config/button_add.png)|Dodaj pozycję. Ten przycisk jest dostępny tylko dla nowych pozycji.| |![](../../../../assets/en/manual/config/button_update.png)|Aktualizuj właściwości pozycji.| |![](../../../../assets/en/manual/config/button_clone.png)|Utwórz inną pozycję na podstawie właściwości bieżącej pozycji.| |![](../../../../assets/en/manual/config/button_execute.png)|Wykonaj natychmiastowe sprawdzenie nowej wartości pozycji. Obsługiwane tylko dla **pasywnych** sprawdzeń (zobacz [więcej szczegółów](/manual/config/items/check_now)).
*Uwaga:* Podczas natychmiastowego sprawdzania wartości, pamięć podręczna konfiguracji nie jest aktualizowana, więc wartość nie będzie odzwierciedlać bardzo niedawnych zmian w konfiguracji pozycji.| |![](../../../../assets/en/manual/config/button_test.png)|Przetestuj, czy konfiguracja pozycji jest poprawna, pobierając wartość.| |![](../../../../assets/en/manual/config/button_clear_history.png)|Usuń historię i trendy pozycji.| |![](../../../../assets/en/manual/config/button_delete.png)|Usuń pozycję.| |![](../../../../assets/en/manual/config/button_cancel.png)|Anuluj edycję właściwości pozycji.| [comment]: # ({/961d04fe-4b126a62}) [comment]: # ({681568e8-8cb32bf5}) #### Ograniczenia danych tekstowych Ograniczenia danych tekstowych zależą od backendu bazy danych. Przed zapisaniem wartości tekstowych do bazy danych są one ucięte, aby dopasować się do limitu typu wartości bazy danych: |Baza danych|Rodzaj informacji|<|<| |--|---|---|---| | |**Znak**|**Log**|**Tekst**| |MySQL|255 znaków|65536 bajtów|65536 bajtów| |PostgreSQL|255 znaków|65536 znaków|65536 znaków| |Oracle|255 znaków|65536 znaków|65536 znaków| |SQLite
(tylko Zabbix proxy)|255 znaków|65536 znaków|65536 znaków| [comment]: # ({/681568e8-8cb32bf5}) [comment]: # ({526f3e7c-d4406a73}) #### Limit własnych skryptów Dostępna długość własnego skryptu zależy od używanej bazy danych: |Baza danych|Limit w znakach|Limit w bajtach| |---|---|---| |**MySQL**|65535|65535| |**Oracle Database**|2048|4000| |**PostgreSQL**|65535|nieograniczony| |**SQLite (tylko proxy Zabbix)**|65535|nieograniczony| [comment]: # ({/526f3e7c-d4406a73}) [comment]: # ({2cd40177-2cd40177}) #### Pozycje nieobsługiwane Pozycja może stać się nieobsługiwana, jeśli jej wartość nie może być pobrana z jakiegoś powodu. Takie pozycje są wciąż ponownie sprawdzane w ich standardowym *[Interwale aktualizacji](/manual/config/items/item?#configuration)*. Nieobsługiwane pozycje są raportowane jako mające stan NIEOBSŁUGIWANY. [comment]: # ({/2cd40177-2cd40177})