Dlaczego warto używać Jamf Device Checker?
Problem
Użytkownicy końcowi często doświadczają problemów z urządzeniami, które wpływają na ich produktywność, ale nie wiedzą, jak je zidentyfikować ani rozwiązać:
- Brakujące lub nieaktualne wersje aplikacji
- Nieaktualne wersje iOS
- Niska kondycja baterii powodująca nieoczekiwane wyłączenia
- Problemy z pojemnością pamięci uniemożliwiające instalację aplikacji
- Problemy z łącznością sieciową wpływające na produktywność
- Przegrzewanie się urządzenia powodujące ograniczanie wydajności
- Wysokie zużycie pamięci/CPU spowalniające pracę
Problemy te zwykle prowadzą do zgłoszeń do help desku, utraty produktywności i frustracji użytkowników.
Rozwiązanie
Jamf Device Checker umożliwia użytkownikom końcowym samodzielne diagnozowanie i rozwiązywanie problemów z gotowością urządzenia dzięki prostemu, oznaczonemu kolorami interfejsowi:
- ✅ Zielony = Urządzenie jest gotowe do pracy
- ⚠️ Żółty = Ostrzeżenia, którymi należy się wkrótce zająć
- 🔴 Czerwony = Krytyczne problemy uniemożliwiające produktywność
Kluczowe korzyści
Dla użytkowników końcowych: samoobsługowe kontrole gotowości urządzenia, jasne, praktyczne wskazówki dotyczące rozwiązywania problemów, krótszy czas oczekiwania na wsparcie IT oraz proaktywne powiadomienia przed terminami.
Dla zespołów IT: mniej zgłoszeń do help desku, egzekwowanie zgodności z zasadami korporacyjnymi (wersje systemu operacyjnego, wymagane aplikacje), wgląd w czasie rzeczywistym w kondycję urządzeń oraz konfigurowalne progi i reguły monitorowania.
Dla organizacji: wyższa produktywność użytkowników końcowych, lepsze zarządzanie cyklem życia urządzeń, niższe koszty wsparcia IT oraz śledzenie i raportowanie zgodności.
Wyświetlanie ogólnego statusu
Aplikacja wyświetla duży, oznaczony kolorami wskaźnik statusu w górnej części głównego ekranu, który podsumowuje ogólną gotowość urządzenia.
| Status | Kolor | Ikona | Opis |
|---|---|---|---|
| Ready | 🟢 Zielony | Znacznik wyboru | Wszystkie włączone kontrole zakończone pomyślnie. Urządzenie spełnia wszystkie wymagania. |
| Deadline Approaching | 🟠 Pomarańczowy | Trójkąt ostrzegawczy | Dostępne aktualizacje ze skonfigurowanymi terminami. Wyświetla "X update(s) available - Y day(s) remain" z odliczaniem do najbliższego terminu. |
| Action Needed | 🟠 Pomarańczowy | Trójkąt ostrzegawczy | Dostępne aktualizacje, ale bez skonfigurowanych terminów. Wyświetla "X update(s) available". |
| Not Ready | 🔴 Czerwony | Znak X | Wymagana jest co najmniej jedna aktualizacja, a termin minął. Wyświetla "X update(s) required". |
| Installing Updates | 🔵 Niebieski | Obracające się strzałki | Polecenia MDM w toku. Wyświetla 2-minutowy licznik odliczający do automatycznego odświeżenia. |
| Off Duty | ⚪ Szary | Księżyc z literami Z | Urządzenie oznaczone jako poza służbą za pomocą Jamf Setup EA. |
| Unknown | ⚪ Szary | Znak zapytania | Stan początkowy przed zakończeniem pierwszej kontroli. |
Szybki start
Wymagania wstępne
- Serwer Jamf Pro (JPS)
- Dostęp administracyjny do Jamf Pro
- Aplikacja Jamf Self Service (wymagana dla funkcji instalacji aplikacji)
- Lokalne konto użytkownika z uprawnieniami kreatora (patrz poniżej)
Wymagane uprawnienia API
Aplikacja korzysta z dwóch odrębnych zestawów uprawnień:
Dla konfiguracji kreatora (lokalne konto użytkownika — używane podczas początkowej konfiguracji):
Utwórz lokalnego użytkownika w Jamf Pro z tymi 8 uprawnieniami:
Konfiguracja integracji API (jednorazowa konfiguracja kreatora):
- Read API Integrations
- Create API Integrations
- Update API Integrations
- Read API Roles
- Create API Roles
- Update API Roles
Zarządzanie App Config (kreator + bieżące aktualizacje):
- Read Mobile Device Applications
- Update Mobile Device Applications
To konto użytkownika uwierzytelnia kreator za pomocą Basic Auth, aby utworzyć integrację API, skonfigurować role, połączyć aplikację natywną i zapisać XML konfiguracji aplikacji. Po początkowej konfiguracji ten użytkownik jest potrzebny tylko do aktualizacji konfiguracji aplikacji (wymaga jedynie 2 uprawnień Mobile Device Applications).
Dla działania w środowisku uruchomieniowym (klient API OAuth — automatycznie konfigurowany przez kreator):
Kreator automatycznie tworzy rolę API "Jamf Device Checker" z tymi 4 uprawnieniami przypisanymi do połączonej integracji aplikacji:
- Send Device Information Command
- View MDM command information in Jamf Pro API
- Read Mobile Devices
- Send MDM command information in Jamf Pro API
Uprawnienia te pozwalają aplikacji Device Checker pobierać szczegóły urządzenia i wysyłać polecenia MDM podczas normalnej pracy przy użyciu uwierzytelniania OAuth. Użytkownicy końcowi nigdy nie widzą ani nie używają tych poświadczeń.
Konfiguracja w 5 minut
Krok 1: Zakup i dodaj aplikację do Jamf Pro
- Zakup "Jamf Device Checker" i przypisz do instancji Jamf Pro w AxM
- Przejdź do Mobile Device Apps w Jamf Pro
- Dodaj "Jamf Device Checker" z sekcji Apps Purchased in Volume
Krok 2: Uruchom kreator konfiguracji
- Zainstaluj aplikację na urządzeniu administracyjnym
- Uruchom aplikację i przytrzymaj dłużej okrągły obraz statusu, aby włączyć tryb kreatora
- Uwierzytelnij się za pomocą użytkownika lokalnego (wymaga 8 uprawnień kreatora — patrz Wymagane uprawnienia API powyżej)
- Postępuj zgodnie z kreatorem, aby:
- Skonfigurować rolę API z wymaganymi uprawnieniami
- Utworzyć integrację API
- Połączyć aplikację natywną z integracją API w celu uwierzytelniania
- Wygenerować zarządzaną konfigurację aplikacji i zapisać ją w JPS
Nie ma kroku 3 — po prostu określ zakres dla urządzeń użytkowników końcowych.
Pełne instrukcje konfiguracji
Krok 1: Dodaj aplikację urządzenia mobilnego do Jamf Pro
- Zakup "Jamf Device Checker" i przypisz do instancji Jamf Pro w AxM
- Zaloguj się do Jamf Pro
- Przejdź do Devices > Mobile Device Apps
- Kliknij + New
- Wyszukaj "Jamf Device Checker" w Apps Purchased in Volume
- Kliknij Add, aby dodać rekord aplikacji do instancji Jamf Pro
Krok 2: Uruchom kreator konfiguracji
Kreator automatycznie obsługuje całe uwierzytelnianie i zarządzaną konfigurację aplikacji.
Zainstaluj aplikację na urządzeniu administracyjnym
- Przypisz aplikację do testowego urządzenia iOS
- Uruchom Jamf Device Checker
Włącz tryb kreatora
- Na karcie More przytrzymaj dłużej ikonę aplikacji przez 3 sekundy
- Wybierz Wizard Setup
- Uwierzytelnij się za pomocą poświadczeń użytkownika lokalnego utworzonych w Wymaganiach wstępnych (wymaga 8 uprawnień kreatora)
Ukończ kroki kreatora
Rola API
- Kreator sprawdza istnienie roli API "Jamf Device Checker"
- Jeśli nie zostanie znaleziona, tworzy rolę z wymaganymi uprawnieniami:
- Send Device Information Command
- View MDM command information in Jamf Pro API
- Read Mobile Devices
- Send MDM command information in Jamf Pro API
- Łączy rolę z integracją API
Uwierzytelnianie aplikacji natywnej
- Kreator łączy rekord aplikacji urządzenia mobilnego z integracją API
- Umożliwia dostarczanie kodu autoryzacji OAuth za pomocą Managed App Config
Wygeneruj konfigurację aplikacji
- Kreator generuje pełną konfigurację Managed App Config
- Wysyła ją do Jamf Pro
Krok 3: Określ zakres dla urządzeń
- W tym samym rekordzie aplikacji kliknij Scope
- Dodaj docelowe grupy urządzeń, grupy inteligentne lub pojedyncze urządzenia
- Kliknij Save
Dokumentacja konfiguracji
Aplikacja jest konfigurowana w całości za pomocą Managed App Config w Jamf Pro. Poniżej znajduje się pełna dokumentacja wszystkich dostępnych kluczy.
Klucze wymagane
Klucze te są automatycznie wypełniane przez Jamf Pro — nie modyfikuj ich ani nie usuwaj.
| Klucz | Opis |
|---|---|
JPS_URL |
URL serwera Jamf Pro (wypełniany automatycznie: $JPS_URL) |
JSSID |
JSS ID urządzenia (wypełniany automatycznie: $JSSID) |
MANAGEMENTID |
Management ID urządzenia (wypełniany automatycznie: $MANAGEMENTID) |
OAUTH_AUTH_CODE |
Kod autoryzacji OAuth (wypełniany automatycznie: $OAUTH_AUTH_CODE) |
APP_CONFIG_REINSTALL_CODE |
Kod wyzwalający ponowną instalację (wypełniany automatycznie: $APP_CONFIG_REINSTALL_CODE) |
APPJSSID |
ID rekordu aplikacji Jamf Device Checker (wypełniany automatycznie: $APPJSSID) |
URL brandingu i alertów
| Klucz | Typ | Domyślnie | Opis |
|---|---|---|---|
device-checker-branding-image-url |
String | (puste) | URL do obrazu logo firmy (PNG/JPG). Pozostaw puste, aby wyłączyć branding. |
device-checker-branding-image-height |
Integer | 80 |
Wysokość logo w punktach. |
device-checker-alerts-url |
String | (puste) | Opcjonalny URL strony alertów/statusu. Wyświetla łącze na karcie Alerts. |
Przykład:
<key>device-checker-branding-image-url</key>
<string>https://yourcompany.com/logo.png</string>
<key>device-checker-branding-image-height</key>
<string>60</string>
Przyciski udostępniania
Kontroluje widoczność funkcji udostępniania statusu i eksportu dzienników na karcie More.
| Klucz | Typ | Domyślnie | Opis |
|---|---|---|---|
device-checker-send-status-enabled |
String | YES |
Pokaż przycisk "Send Status" (udostępnia podsumowanie gotowości urządzenia przez e-mail/wiadomości) |
device-checker-send-logs-enabled |
String | YES |
Pokaż przycisk "Send Logs" (eksportuje dzienniki aplikacji do rozwiązywania problemów) |
Przykład:
<key>device-checker-send-status-enabled</key>
<string>YES</string>
<key>device-checker-send-logs-enabled</key>
<string>NO</string>
Zachowanie interfejsu
Kontroluje zachowanie przewijania na karcie Status.
| Klucz | Typ | Domyślnie | Opis |
|---|---|---|---|
device-checker-status-tab-scrollable |
String | NO |
Gdy YES, cała karta Status staje się przewijalna (nagłówek + status ogólny + kafelki). Gdy NO (domyślnie), nagłówek i status ogólny pozostają nieruchome, a przewijają się tylko kafelki poniżej. |
Przykład:
<key>device-checker-status-tab-scrollable</key>
<string>NO</string>
Kiedy włączyć: Ustawienie domyślne (NO) jest najlepsze dla większości wdrożeń — nagłówek i ogólny status gotowości pozostają widoczne podczas przewijania kafelków. Ustaw na YES, gdy potrzebujesz, aby cały widok przewijał się razem, lub aby dostosować się do dłuższych nagłówków brandingu na mniejszych urządzeniach.
Gotowość systemu operacyjnego
Monitoruj wymaganie dotyczące wersji systemu operacyjnego z konfigurowalną minimalną wersją i terminem.
| Klucz | Typ | Domyślnie | Opis |
|---|---|---|---|
device-checker-os-enabled |
String | YES |
Włącz kafelek monitorowania wersji systemu operacyjnego |
device-checker-os-min-version |
String | (brak) | Minimalna wymagana wersja systemu operacyjnego (np. 26.2) |
device-checker-os-deadline |
String | (brak) | Termin wymagania w formacie YYYY-MM-DD |
Przykład:
<key>device-checker-os-enabled</key>
<string>YES</string>
<key>device-checker-os-min-version</key>
<string>26.2</string>
<key>device-checker-os-deadline</key>
<string>2026-06-30</string>
Logika statusu:
✅ Zielony (Ready) — Bieżąca wersja systemu operacyjnego spełnia minimalne wymaganie
⚠️ Żółty (Warning) — Bieżąca wersja systemu operacyjnego poniżej minimum, ale termin NIE minął (lub brak skonfigurowanego terminu)
🔴 Czerwony (Not Ready) — Bieżąca wersja systemu operacyjnego poniżej minimum ORAZ termin minął
Gotowość aplikacji
Monitoruj stan instalacji i wymagania dotyczące wersji dla wymaganych zarządzanych aplikacji.
| Klucz | Typ | Domyślnie | Opis |
|---|---|---|---|
device-checker-apps-enabled |
String | NO |
Włącz kafelek monitorowania aplikacji |
device-checker-apps-list |
String | (puste) | Lista aplikacji rozdzielona pionowymi kreskami (format poniżej) |
Format listy aplikacji:
AppName,bundleID,minVersion,deadline|AppName2,bundleID2,minVersion2,deadline2|...
Przykład:
<key>device-checker-apps-enabled</key>
<string>YES</string>
<key>device-checker-apps-list</key>
<string>Slack,com.tinyspeck.chatlyio,24.0.0,2026-03-01|Microsoft Teams,com.microsoft.skype.teams,5.0.0,2026-06-01</string>
Logika statusu:
✅ Zielony (Ready) — Wszystkie aplikacje zainstalowane i spełniają minimalne wersje
⚠️ Żółty (Warning) — Co najmniej jedna aplikacja wymaga aktualizacji, ale termin NIE minął
🔴 Czerwony (Not Ready) — Co najmniej jedna aplikacja wymaga aktualizacji ORAZ termin minął
⏳ Pending — Instalacja aplikacji w toku (patrz integracja z Self Service poniżej)
Integracja z Self Service:
Gdy aplikacje są brakujące lub nieaktualne, użytkownicy mogą stuknąć przycisk "Update Apps" na kafelku Apps, aby automatycznie zainstalować lub zaktualizować wymagane aplikacje. Przebieg pracy jest następujący:
- Użytkownik stuka przycisk "Update Apps" na kafelku Apps
- Aplikacja Jamf Self Service otwiera się automatycznie z brakującymi/nieaktualnymi aplikacjami w kolejce
- Device Checker przechodzi w status "Pending" i uruchamia 2-minutowy licznik automatycznego odświeżania
- Aplikacja automatycznie odświeża się co 2 minuty, aby sprawdzić, czy instalacje zostały ukończone
- Gdy wszystkie aplikacje spełniają wymagania, status powraca do zielonego
Wymagania: Jamf Self Service musi być zainstalowany na urządzeniu, aplikacje muszą być dostępne w Self Service i objęte zakresem urządzenia, a aplikacje muszą mieć zaznaczone "Display app in Self Service after it is installed" w Jamf Pro.
Uwagi:
- Bundle ID musi być dokładnie dopasowany (rozróżniana wielkość liter)
- Porównanie wersji korzysta z wersjonowania semantycznego (np.
2.5.0>2.4.9) - Termin jest opcjonalny (pozostaw puste, jeśli niepotrzebny:
AppName,bundleID,minVersion,)
Źródło zasilania (poziom baterii)
Monitoruj poziom naładowania baterii z konfigurowalnymi progami ostrzeżenia i wartościami krytycznymi.
| Klucz | Typ | Domyślnie | Opis |
|---|---|---|---|
device-checker-power-source-enabled |
String | YES |
Włącz kafelek monitorowania poziomu baterii |
device-checker-power-source-warning |
Integer | 25 |
Próg ostrzeżenia (procent) |
device-checker-power-source-critical |
Integer | 10 |
Próg krytyczny (procent) |
Przykład:
<key>device-checker-power-source-enabled</key>
<string>YES</string>
<key>device-checker-power-source-warning</key>
<string>25</string>
<key>device-checker-power-source-critical</key>
<string>10</string>
Logika statusu:
🔴 Czerwony (Critical) — Bateria ≤ próg krytyczny
⚠️ Żółty (Warning) — Bateria ≤ próg ostrzeżenia (ale > krytyczny)
✅ Zielony (Ready) — Bateria > próg ostrzeżenia
⚡ Charging — Urządzenie jest podłączone do zasilania (zawsze zielony podczas ładowania)
Pojemność pamięci
Monitoruj dostępną pamięć z konfigurowalnymi progami ostrzeżenia i wartościami krytycznymi (na podstawie procentowego wykorzystania).
| Klucz | Typ | Domyślnie | Opis |
|---|---|---|---|
device-checker-storage-enabled |
String | YES |
Włącz kafelek monitorowania pamięci |
device-checker-storage-warning |
Integer | 75 |
Próg ostrzeżenia (% wykorzystania) |
device-checker-storage-critical |
Integer | 90 |
Próg krytyczny (% wykorzystania) |
Przykład:
<key>device-checker-storage-enabled</key>
<string>YES</string>
<key>device-checker-storage-warning</key>
<string>75</string>
<key>device-checker-storage-critical</key>
<string>90</string>
Logika statusu:
🔴 Czerwony (Critical) — Wykorzystanie pamięci ≥ próg krytyczny
⚠️ Żółty (Warning) — Wykorzystanie pamięci ≥ próg ostrzeżenia (ale < krytyczny)
✅ Zielony (Ready) — Wykorzystanie pamięci < próg ostrzeżenia
Kondycja baterii
Monitoruj stan kondycji baterii, aby identyfikować urządzenia, które mogą wymagać wymiany baterii. Ten kafelek wyświetla stan kondycji baterii i bieżący procent naładowania.
| Klucz | Typ | Domyślnie | Opis |
|---|---|---|---|
device-checker-battery-enabled |
String | YES |
Włącz kafelek monitorowania kondycji baterii |
Przykład:
<key>device-checker-battery-enabled</key>
<string>YES</string>
Logika statusu:
✅ Zielony (Ready) — Kondycja baterii to "Normal" lub "Unsupported"
🔴 Czerwony (Not Ready) — Kondycja baterii to "Service-Recommended" lub "Non-Genuine"
⚪ Szary (Unknown) — Kondycja baterii to "Unknown" lub nie można pobrać danych baterii
Wartości stanu kondycji:
- Normal — Bateria działa prawidłowo (zielony)
- Service-Recommended — Pojemność baterii uległa degradacji, zalecana wymiana (czerwony)
- Non-Genuine — Wykryto baterię inną niż Apple, zalecana wymiana (czerwony)
- Unsupported — Monitorowanie kondycji baterii niedostępne dla tego modelu urządzenia (zielony, wyświetla tylko % naładowania)
- Unknown — Dane o kondycji jeszcze niedostępne w iOS (szary, wyświetla tylko % naładowania)
Wyświetlanie kafelka: Kolor statusu i ikona zależą od kondycji baterii. Podtytuł pokazuje problem z kondycją baterii, jeśli występuje, w przeciwnym razie wyświetla bieżący procent naładowania. Widok szczegółów pokazuje poziom naładowania, stan ładowania, tryb niskiego zużycia energii, stan kondycji baterii i zalecenia.
Uwagi:
- Dane o kondycji baterii pochodzą z Declarative Device Management (DDM)
- Nowe urządzenia mogą wyświetlać "Unknown" do czasu, aż iOS obliczy metryki kondycji (zwykle po kilku cyklach ładowania)
- Procent naładowania jest zawsze wyświetlany w podtytule lub widoku szczegółów
- Ten kafelek koncentruje się na kondycji baterii; użyj kafelka Power Source do monitorowania poziomu naładowania z progami
Stan termiczny
Monitoruj temperaturę urządzenia w czasie rzeczywistym za pomocą lokalnych interfejsów API iOS (bez konieczności wywołań MDM).
| Klucz | Typ | Domyślnie | Opis |
|---|---|---|---|
device-checker-thermal-enabled |
String | YES |
Włącz kafelek monitorowania stanu termicznego |
Przykład:
<key>device-checker-thermal-enabled</key>
<string>YES</string>
Logika statusu:
✅ Zielony (Nominal) — Normalna temperatura pracy, wszystkie funkcje działają prawidłowo
⚠️ Żółty (Fair) — Nieznacznie podwyższona, system odracza pracę w tle, taką jak wstępne pobieranie/indeksowanie
🔴 Czerwony (Serious) — Wysoka temperatura, aktywne ograniczanie CPU/GPU, liczba klatek może spaść do 30 FPS
🔴 Czerwony (Critical) — Urządzenie krytycznie gorące, znaczące ograniczanie, aparat/lampa błyskowa/głośnik mogą zostać wyłączone, ryzyko wyłączenia
Przypadki użycia: urządzenia terenowe w gorących środowiskach (pojazdy, praca na zewnątrz), użytkownicy uruchamiający intensywne aplikacje (nagrywanie wideo, AR), proaktywne ostrzeżenia przed wyłączeniami termicznymi oraz zrozumienie ograniczania wydajności.
Uwagi: Monitorowanie w czasie rzeczywistym za pomocą iOS ProcessInfo API. Brak wywołań API ani zużycia baterii. Aktualizuje się natychmiast po zmianie stanu termicznego.
Wydajność (pamięć i CPU)
Monitoruj presję pamięci urządzenia i wykorzystanie CPU za pomocą lokalnych interfejsów API iOS z konfigurowalnymi progami.
| Klucz | Typ | Domyślnie | Opis |
|---|---|---|---|
device-checker-performance-enabled |
String | YES |
Włącz kafelek monitorowania wydajności |
device-checker-memory-warning |
Integer | 70 |
Próg ostrzeżenia pamięci (% wykorzystania) |
device-checker-memory-critical |
Integer | 85 |
Próg krytyczny pamięci (% wykorzystania) |
device-checker-cpu-warning |
Integer | 60 |
Próg ostrzeżenia CPU (% wykorzystania) |
device-checker-cpu-critical |
Integer | 80 |
Próg krytyczny CPU (% wykorzystania) |
Przykład:
<key>device-checker-performance-enabled</key>
<string>YES</string>
<key>device-checker-memory-warning</key>
<string>70</string>
<key>device-checker-memory-critical</key>
<string>85</string>
<key>device-checker-cpu-warning</key>
<string>60</string>
<key>device-checker-cpu-critical</key>
<string>80</string>
Logika statusu:
🔴 Czerwony (Critical) — Pamięć LUB CPU ≥ próg krytyczny
⚠️ Żółty (Warning) — Pamięć LUB CPU ≥ próg ostrzeżenia (ale < krytyczny)
✅ Zielony (Ready) — Zarówno pamięć, JAK I CPU < progi ostrzeżenia
Uwagi: Aktualizuje się co 5 sekund, gdy kafelek jest widoczny. Monitorowanie wstrzymuje się, gdy aplikacja działa w tle (aby oszczędzać baterię). Brak wymaganych zdalnych wywołań API — monitorowanie w całości lokalne za pomocą os_proc_available_memory() dla pamięci i host_statistics() dla CPU.
Stan sieci
Monitoruj stan łączności WiFi, Ethernet i komórkowej.
| Klucz | Typ | Domyślnie | Opis |
|---|---|---|---|
device-checker-wifi-enabled |
String | YES |
Włącz kafelek monitorowania WiFi/Ethernet (Ethernet jest automatycznie wykrywany po podłączeniu) |
device-checker-cellular-enabled |
String | NO |
Włącz kafelek monitorowania łączności komórkowej |
device-checker-network-speed-enabled |
String | NO |
Włącz przycisk testu prędkości sieci w widokach szczegółów sieci |
Przykład:
<key>device-checker-wifi-enabled</key>
<string>YES</string>
<key>device-checker-cellular-enabled</key>
<string>YES</string>
<key>device-checker-network-speed-enabled</key>
<string>YES</string>
Szczegóły testu prędkości sieci:
Test prędkości to narzędzie diagnostyczne na żądanie (~10–15 MB na test, czas trwania ~15–20 sekund), które mierzy prędkości pobierania/wysyłania oraz opóźnienie. Przed każdym testem w sieci komórkowej wyświetlane jest ostrzeżenie informujące o zużyciu danych. Wyniki mają charakter wyłącznie informacyjny i nie wpływają na status gotowości urządzenia. Przypadki użycia obejmują weryfikację łączności przez pracowników terenowych, rozwiązywanie problemów z niską wydajnością oraz walidację wymagań dotyczących przepustowości.
Test łączności z internetem (WiFi, Ethernet i sieć komórkowa)
Lekki test weryfikujący rzeczywistą osiągalność internetu w porównaniu z samą łącznością interfejsu.
| Klucz | Typ | Domyślnie | Opis |
|---|---|---|---|
device-checker-internet-connectivity-test-enabled |
String | NO |
Włącz test łączności z internetem dla wszystkich interfejsów |
device-checker-internet-connectivity-test-endpoint |
String | http://captive.apple.com/hotspot-detect.html |
URL punktu końcowego testu (domyślnie captive portal Apple) |
device-checker-internet-connectivity-test-timeout |
String | 3 |
Limit czasu żądania w sekundach (zakres 1–10) |
device-checker-internet-connectivity-test-cache-ttl |
String | 30 |
Ważność zapisanego w pamięci podręcznej wyniku w sekundach (zakres 10–300; sieć komórkowa używa minimum 60 s) |
Przykład:
<key>device-checker-internet-connectivity-test-enabled</key>
<string>YES</string>
<key>device-checker-internet-connectivity-test-timeout</key>
<string>5</string>
<key>device-checker-internet-connectivity-test-cache-ttl</key>
<string>60</string>
Jak to działa: Wysyła lekkie żądanie HEAD (~200–500 bajtów) do punktu końcowego captive portal Apple. Testy uruchamiają się automatycznie po połączeniu interfejsu lub po otwarciu widoków szczegółów sieci (jeśli pamięć podręczna wygasła). Wyniki są zapisywane w pamięci podręcznej na 30 sekund dla WiFi/Ethernet i minimum 60 sekund dla sieci komórkowej, aby zminimalizować zużycie danych. Kafelki sieci pokazują status żółty/ostrzegawczy, jeśli są połączone, ale nie wykryto internetu.
Zachowanie statusu według interfejsu:
WiFi — Zielony: połączono z potwierdzonym internetem. Żółty: połączono, ale brak internetu (captive portal, problem z routingiem). Czerwony: brak połączenia.
Ethernet — Zielony: połączono z potwierdzonym internetem. Żółty: połączono, ale brak internetu (problem z routingiem/zaporą). Czerwony: brak połączenia.
Sieć komórkowa — Zielony: włączona z potwierdzonym internetem. Żółty: włączona, ale brak internetu (problem operatora, problem z kontem). Czerwony: niedostępna lub wyłączona.
Zużycie danych: ~200–500 bajtów na test (w porównaniu z ~10–15 MB dla testu prędkości). WiFi/Ethernet z 30-sekundową pamięcią podręczną: typowo mniej niż 100 KB/dzień. Sieć komórkowa z 60-sekundową pamięcią podręczną: typowo mniej niż 50 KB/dzień.
Logika statusu bez testu łączności z internetem:
WiFi: ✅ Zielony (Connected) — Połączono z WiFi. 🔴 Czerwony (Not Connected) — Brak połączenia z WiFi.
Sieć komórkowa: ✅ Zielony (Ready) — Dane komórkowe dostępne. ⚠️ Żółty (Warning) — Dostęp komórkowy ograniczony. 🔴 Czerwony (Error) — Sieć komórkowa niedostępna.
Atrybut rozszerzenia Jamf Setup
Wyświetl status na służbie/poza służbą z atrybutu rozszerzenia Jamf Pro.
| Klucz | Typ | Domyślnie | Opis |
|---|---|---|---|
device-checker-jamf-setup-ea-enabled |
String | NO |
Włącz kafelek Jamf Setup EA |
device-checker-jamf-setup-ea-name |
String | (puste) | Nazwa atrybutu rozszerzenia w Jamf Pro |
device-checker-jamf-setup-ea-on-duty-value |
String | (puste) | Wartość oznaczająca "na służbie" |
device-checker-jamf-setup-ea-off-duty-value |
String | (puste) | Wartość oznaczająca "poza służbą" |
Przykład:
<key>device-checker-jamf-setup-ea-enabled</key>
<string>YES</string>
<key>device-checker-jamf-setup-ea-name</key>
<string>Jamf Setup</string>
<key>device-checker-jamf-setup-ea-on-duty-value</key>
<string>On-duty</string>
<key>device-checker-jamf-setup-ea-off-duty-value</key>
<string>Off-duty</string>
Logika statusu:
✅ Zielony (Ready) — Wartość EA odpowiada wartości na służbie
⚠️ Żółty (Warning) — Wartość EA odpowiada wartości poza służbą
⚪ Szary (Unknown) — Nie znaleziono EA lub wartość nie odpowiada żadnej ze skonfigurowanych wartości
Uwagi: Wymaga niestandardowego atrybutu rozszerzenia w Jamf Pro. Atrybut rozszerzenia musi być wypełniany przez Jamf Setup lub inną metodę.
Ograniczanie automatycznego odświeżania
Kontroluje, jak często aplikacja automatycznie odświeża się po powrocie z tła.
| Klucz | Typ | Domyślnie | Opis |
|---|---|---|---|
device-checker-auto-refresh-threshold |
Integer | 300 |
Minimalna liczba sekund między automatycznymi odświeżeniami (zakres: 60–3600 lub 0, aby wyłączyć) |
Przykład:
<key>device-checker-auto-refresh-threshold</key>
<string>300</string>
Zachowanie:
- Domyślnie (300 sekund / 5 minut): Jeśli użytkownik przełączy aplikacje i powróci w ciągu 5 minut, automatyczne odświeżanie nie następuje
- Niestandardowy próg: Ustaw na żądaną liczbę sekund (60–3600)
- Wyłącz ograniczanie: Ustaw na
0, aby zawsze odświeżać, gdy aplikacja staje się aktywna
Zawsze odświeża (ograniczanie pominięte): pierwsza aktywacja po uruchomieniu aplikacji, w stanie oczekiwania (automatyczne odświeżanie co 2 minuty), ręczne stuknięcia przycisku odświeżania oraz wygaśnięcie licznika w stanie oczekiwania.
Zachowanie stanu oczekiwania: Gdy kafelek Apps przechodzi w stan "Pending" (po stuknięciu przez użytkownika "Update Apps"), aplikacja automatycznie sprawdza status urządzenia co 2 minuty, aż wszystkie wymagane aplikacje zostaną zainstalowane, niezależnie od ustawienia progu automatycznego odświeżania.
Przykłady konfiguracji
Konfiguracja minimalna (ustawienia domyślne)
Idealna do szybkiego testowania lub podstawowych wdrożeń.
<dict>
<!-- Required keys (auto-populated) -->
<key>JPS_URL</key>
<string>$JPS_URL</string>
<key>JSSID</key>
<string>$JSSID</string>
<key>MANAGEMENTID</key>
<string>$MANAGEMENTID</string>
<key>OAUTH_AUTH_CODE</key>
<string>$OAUTH_AUTH_CODE</string>
<key>APP_CONFIG_REINSTALL_CODE</key>
<string>$APP_CONFIG_REINSTALL_CODE</string>
<key>APPJSSID</key>
<string>$APPJSSID</string>
<!-- Enable OS monitoring only -->
<key>device-checker-os-enabled</key>
<string>YES</string>
<key>device-checker-os-min-version</key>
<string>18.0</string>
</dict>
Pełna konfiguracja
Kompleksowa konfiguracja z brandingiem, wieloma kontrolami statusu urządzenia i niestandardowymi progami.
<dict>
<!-- Required keys (auto-populated) -->
<key>JPS_URL</key>
<string>$JPS_URL</string>
<key>JSSID</key>
<string>$JSSID</string>
<key>MANAGEMENTID</key>
<string>$MANAGEMENTID</string>
<key>OAUTH_AUTH_CODE</key>
<string>$OAUTH_AUTH_CODE</string>
<key>APP_CONFIG_REINSTALL_CODE</key>
<string>$APP_CONFIG_REINSTALL_CODE</string>
<key>APPJSSID</key>
<string>$APPJSSID</string>
<!-- Branding -->
<key>device-checker-branding-image-url</key>
<string>https://yourcompany.com/logo.png</string>
<key>device-checker-branding-image-height</key>
<string>60</string>
<!-- OS Readiness -->
<key>device-checker-os-enabled</key>
<string>YES</string>
<key>device-checker-os-min-version</key>
<string>18.0</string>
<key>device-checker-os-deadline</key>
<string>2026-12-31</string>
<!-- App Readiness -->
<key>device-checker-apps-enabled</key>
<string>YES</string>
<key>device-checker-apps-list</key>
<string>Slack,com.tinyspeck.chatlyio,24.0.0,2026-06-01|Microsoft Teams,com.microsoft.skype.teams,5.0.0,2026-09-01</string>
<!-- Device Health Tiles -->
<key>device-checker-power-source-enabled</key>
<string>YES</string>
<key>device-checker-power-source-warning</key>
<string>30</string>
<key>device-checker-power-source-critical</key>
<string>15</string>
<key>device-checker-storage-enabled</key>
<string>YES</string>
<key>device-checker-storage-warning</key>
<string>70</string>
<key>device-checker-storage-critical</key>
<string>85</string>
<key>device-checker-battery-enabled</key>
<string>YES</string>
<key>device-checker-thermal-enabled</key>
<string>YES</string>
<key>device-checker-performance-enabled</key>
<string>YES</string>
<key>device-checker-memory-warning</key>
<string>75</string>
<key>device-checker-memory-critical</key>
<string>90</string>
<key>device-checker-cpu-warning</key>
<string>70</string>
<key>device-checker-cpu-critical</key>
<string>85</string>
<key>device-checker-wifi-enabled</key>
<string>YES</string>
<key>device-checker-cellular-enabled</key>
<string>NO</string>
<!-- Network Speed Test (optional - disabled by default) -->
<key>device-checker-network-speed-enabled</key>
<string>NO</string>
<!-- Internet Connectivity Test (optional - disabled by default) -->
<key>device-checker-internet-connectivity-test-enabled</key>
<string>NO</string>
<key>device-checker-internet-connectivity-test-endpoint</key>
<string>http://captive.apple.com/hotspot-detect.html</string>
<key>device-checker-internet-connectivity-test-timeout</key>
<string>3</string>
<key>device-checker-internet-connectivity-test-cache-ttl</key>
<string>30</string>
<!-- Jamf Setup EA -->
<key>device-checker-jamf-setup-ea-enabled</key>
<string>YES</string>
<key>device-checker-jamf-setup-ea-name</key>
<string>Device Status</string>
<key>device-checker-jamf-setup-ea-on-duty-value</key>
<string>Active</string>
<key>device-checker-jamf-setup-ea-off-duty-value</key>
<string>Spare Pool</string>
<!-- UI Options -->
<key>device-checker-alerts-url</key>
<string>https://status.yourcompany.com</string>
<key>device-checker-send-status-enabled</key>
<string>YES</string>
<key>device-checker-send-logs-enabled</key>
<string>NO</string>
<key>device-checker-status-tab-scrollable</key>
<string>NO</string>
<!-- Auto-Refresh (10 minutes) -->
<key>device-checker-auto-refresh-threshold</key>
<string>600</string>
</dict>
Informacje prawne
- Umowa użytkowania: Application End User License Agreement
- Polityka prywatności: Jamf Privacy Policy