Repository navigation
0.27.0 #1751
mickem
announced in
Announcements
0.27.0
#1751
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
Failed checks that explain themselves, a native Icinga 2 agent, and a Checkmk agent that matches the official one
0.27.0 is about the moment a check fails. The agent now keeps a log of its last failed checks, and can keep the metrics and diagnostics tables (top processes, services in trouble, the last log errors, the usual disk growth spots) from that moment, on the host and for the fleet server. It also adds an experimental
IcingaAgentmodule that joins an Icinga 2 cluster natively, brings the Checkmk agent dump in line with the official agent, and adds pressure metrics, per-volume growth, and Hyper-V over-commitment and switch checks.✨ Highlights
GET /api/v2/failures(feature: keep and show a log of the last failed checks #1697).capture metricsandcapture diagnosticson, each failure keeps the metrics snapshot and small diagnostics tables from that moment. A new Diagnostics page shows them live, and an enrolled agent can send failure context to the fleet server (feature: metrics context for failed checks, reported to the fleet server once an interval #1699, feature: diagnostics tables that explain a failed check #1710).IcingaAgent: NSClient++ as a native Icinga 2 agent (experimental). It speaks the cluster protocol on port 5665, requests its certificate from the Icinga CA and runs the checks the master schedules withcommand_endpoint(feature: add IcingaAgent module for native Icinga 2 cluster protocol support #1736).<<<cpu>>>and<<<kernel>>>sections, the full memory data, process owners and exact numbers.nscp mk installsets the agent up from the command line (feature: Checkmk agent sections now match official agent output #1719).check_drivesizekeywords (feature: diagnostics tables that explain a failed check #1710).check_hyperv_hostreports CPU and memory over-commitment, the newcheck_hyperv_switcheschecks every virtual switch, andcheck_hyperv_vmsfinds duplicate VM names (feature: Hyper-V over-commitment, virtual switches and duplicate VM names #1718).🔍 Detailed changes
🧾 Core — the failed-check log
The log is on by default and lives in memory only. Configure it under
[/settings/core/failed checks], or in the new folded Failed-check log settings card on the Failed checks page:enabled,max entries,statusesrecord argumentsnone,safe(default: thresholds, filter, syntax and what was checked) orall(every option, withpassword/tokenvalues as***).capture metrics,capture diagnosticsmetrics context budget,max context sizeprune metrics,prune patternzeros, empty, duplicates, or keys containing a text.GET /api/v2/failurestakes?status=,?command=,?since=and?limit=.GET /api/v2/failures/<index>/contextserves the snapshot, andDELETEempties the log. The endpoints need the newfailures.list/failures.deletegrants, which only the built-infullrole holds.🔍 Core — diagnostics
capture diagnosticskeeps small tables with each failure, each switched on in the module that produces it:processes.top_cpu,processes.top_memoryservices.problems,services.eventseventlog.errorsdisk.growth_spotsfailures.recentGET /api/v2/diagnostics(newdiagnostics.listgrant) serves the latest snapshot live, andnscp testgains adiagnostics [section]command. An enrolled agent sends at most one failure-context report perfailure context interval(default1h) to a fleet server that asks for one. Setfailure context = falseunder[/settings/fleet]to send none.🧊 IcingaAgent — a native Icinga 2 agent (experimental)
The module is not loaded by default and does nothing until
/settings/Icinga/agenthas aparent hostand aparent endpoint. It then connects to an Icinga 2 master or satellite, gets a certificate (straight away with aticket, otherwise aftericinga2 ca sign), and runs the checks it is sent. CheckCommands importifw-api, the same convention Icinga for Windows uses. Checks run asIcingaAgent:<parent endpoint>, so the permission policy decides what the parent may run.tls versionandallowed cipherstune the connection. Install the master'sca.crt, or setparent fingerprint, so the first connection is verified too.📤 CheckMKServer — official agent sections and
nscp mk install<<<cpu>>>,<<<kernel>>>/proc/vmstatand/proc/stat.<<<mem>>>/proc/meminfoon Linux, commit limit and virtual memory on Windows, exact values.<<<df>>>check_drivesizeon Linux, with inode counts (needsCheckDisk).<<<ps>>><<<services>>>auto, as the official agent sends them.<<<check_mk>>>OSType,OSNameandOSVersion, which becomecmk/os_*host labels.The install command enables
CheckMKServer,CheckSystemandCheckDisk, and adds local checks and MRPE entries. A re-run only changes what it is given.📊 Metrics — pressure, volume growth and a Metrics page that explains itself
system.pressure.*adds the Linux pressure stall figures for CPU, memory and I/O, major faults, and the Windows processor queue length and page faults.disk.io.<disk>.avg_queue_lengthjoins the instantaneous queue length on both platforms.disk.free.<drive>.used_change_1hand_24hsay how much a volume grew, andcheck_drivesizegains the same keywords:warn=used_change_1h > 2G. They readunknownuntil the agent has a full hour (or day) of history.640.5 GiB,34 %), grouped by module and instance (feature: show metric metadata in web UI Metrics page #1713, feature: group the Metrics page by instance and show values with their unit #1715).check_mssql_countersgainslatch_wait_ms, the average latch wait (feature: report the average latch wait in check_mssql_counters #1737).🖥️ Windows — Hyper-V and SCVMM
check_hyperv_hostgainsrunning_vms,vm_vcpus,cpu_overcommit,memory_assigned,physical_memoryandmemory_overcommit. It now reads the VMs over WMI, so it needs the same rights ascheck_hyperv_vms. When it cannot,guests_knownis false andguests_errorsays why.check_hyperv_switchesis new:type,state,healthandportsfor every virtual switch.check_hyperv_vmsgainsname_count(critical=name_count > 1), andhealthreadsdegraded,minor_failure, ... instead ofhealth_10,health_15, ... (feature: Hyper-V over-commitment, virtual switches and duplicate VM names #1718).scripts\check_scvmm_hosts.ps1is a new sample script that checks every host System Center VMM manages (feature: sample script for Hyper-V hosts as SCVMM sees them #1720).🛰️ Fleet and core
poll interval,min poll intervalandmax poll intervalunder[/settings/fleet]bound how often the host polls, whatever the server asks for (Unit test the fleet sync and let the host bound its poll interval #1729).nsclient.dbused to share one namespace between modules. Each module (or alias) now owns its entries, and existing sessions and bookmarks are carried over on first start (fix: isolate stored module state by owner #1726).[/settings/core]keys are known. A misspelled key there now gets a warning naming the key it resembles, andnscp settings --validatefails on it (Register the core's [/settings/core] keys under their names #1731).check_single_file,check_disk_io,check_disk_health,check_tcp,check_dns,check_http,check_connections,check_ntp_offset,check_nscp_updateand theNSCANgClientmodule (Remove experimental flag from stable checks [skip ci] #1714).🔒 Security
🐛 Bug fixes
check_httpandcheck_nsclient_web_onlinehonourtimeout=. Neither applied it, so a server that accepted the connection and never answered held the check forever (fix: make check_nsclient_web_online honour timeout= #1707).check_patch_age. A host with no install dates reported age-1, which looked freshly patched.ageis nowunknown, with a newage_knownflag (feature: report unknown patch age with age_known flag #1734).check_serviceno longer fails every call on a service whose configuration the agent's account cannot read, and the Checkmk<<<services>>>section stays.reportlists accept spaces and any case:report = critical, warningused to submit only criticals.remove_key(). A fleettimeout = 0and negative sizes are refused..zipmodule bundle now shows in the full module listing, the REST module list and the web UI (fix: list unloaded .zip module bundles in the full module listing #1727).📦 Packaging
nsclient failures, which reads the failed-check log and the context kept with each failure,fleet explain, which asks a fleet server to explain an error, andnrpe, which runs a check over NRPE the waycheck_nrpedoes.The full list is on the upgrading page, and the security fixes are on the security notices page.
CheckDiskto keep<<<df>>>. A Lua line object set withline:set_line(...)now sends an embedded line break as a space.failures.list(failures.deleteto clear), and diagnostics needdiagnostics.list.check_hyperv_vmshealth: filters onhealth_0,health_10,health_15orhealth_30must useunknown,degraded,minor_failureornon_recoverable_error.check_patch_age: replaceage < 0orage = -1withage_known = 0.nscp settings --validatenow fails on a misspelled key under[/settings/core]. Fix the spelling it suggests.remove_key()instead.Full Changelog: 0.26.0...0.27.0
This discussion was created from the release 0.27.0.
All reactions