Falco integration metrics

The official Datadog integration for monitoring Falco. It collects 50 metrics.

Official summary

Gain insights into Falco alert logs and metrics

Metric types

  • count (occurrences in the interval): 30
  • gauge (value at a point in time): 20

Metrics

Descriptions are the official definitions, unedited.

MetricTypeUnit
falco.container.memory.usedMemory usage of the Falco process in container deployments (similar to container_memory_working_set_bytes)gaugebyte
falco.cpu.usage.ratioCPU usage percentage of the Falco process (equivalent to ps output)gauge-
falco.duration.seconds.countTotal duration in seconds that Falco has been runningcountsecond
falco.evt.hostnameHostname informationgauge-
falco.evt.sourceEvent source information (e.g. syscall or plugin-based sources)gauge-
falco.host.cpu.usage.ratioOverall CPU usage percentage of all running processes on the host systemgauge-
falco.host.memory.usedOverall memory usage in bytes of all running processes on the host systemgaugebyte
falco.host.num.cpusTotal number of CPUs on the host systemgaugecpu
falco.host.open.fdsTotal number of open file descriptors on the host systemgaugefile
falco.host.procs.runningNumber of currently running processes on the host system (from /proc/stat)gaugeprocess
falco.jemalloc.active.countActive memory allocation by jemalloc memory allocatorcountbyte
falco.jemalloc.allocated.countTotal allocated memory by jemalloc memory allocatorcountbyte
falco.jemalloc.mapped.countMemory mapped by jemalloc memory allocatorcountbyte
falco.jemalloc.metadata.countMemory used for jemalloc metadatacountbyte
falco.jemalloc.metadata.thp.countTransparent huge page memory used for jemalloc metadatacountbyte
falco.jemalloc.resident.countResident memory held by jemalloc memory allocatorcountbyte
falco.jemalloc.retained.countMemory retained by jemalloc for future allocationscountbyte
falco.jemalloc.zero.reallocs.countMemory from zero-sized reallocations in jemalloccountbyte
falco.kernel.releaseKernel release version informationgauge-
falco.memory.pssProportional Set Size memory usage of the Falco processgaugebyte
falco.memory.rssResident Set Size memory usage of the Falco processgaugebyte
falco.memory.vszVirtual Set Size memory usage of the Falco processgaugebyte
falco.outputs.queue.num.drops.countTotal number of events dropped from the output queuecount-
falco.rules.matches.countTotal number of rule matches detected by Falco security rulescount-
falco.scap.engine.nameSCAP engine information (e.g. bpf modern_bpf or kmod)gauge-
falco.scap.n.added.fds.countTotal number of file descriptors added to the internal tracking tablescountfile
falco.scap.n.added.threads.countTotal number of threads added to the internal tracking tablescountthread
falco.scap.n.cached.fd.lookups.countTotal number of successful file descriptor lookups from cachecount-
falco.scap.n.cached.thread.lookups.countTotal number of successful thread lookups from cachecount-
falco.scap.n.containersCurrent number of containers being trackedgauge-
falco.scap.n.drops.buffer.countTotal number of events dropped due to buffer issuescount-
falco.scap.n.drops.countTotal number of kernel-side event dropscount-
falco.scap.n.drops.full.threadtable.countTotal number of events dropped due to full thread tablecount-
falco.scap.n.drops.scratch.map.countTotal number of events dropped due to scratch map issuescount-
falco.scap.n.evts.countTotal number of events captured by the system call capture enginecount-
falco.scap.n.failed.fd.lookups.countTotal number of failed file descriptor lookupscountfile
falco.scap.n.failed.thread.lookups.countTotal number of failed thread lookupscount-
falco.scap.n.fdsCurrent number of file descriptors stored in internal tablesgaugefile
falco.scap.n.missing.container.imagesNumber of containers with missing or unknown container imagesgauge-
falco.scap.n.noncached.fd.lookups.countTotal number of non-cached file descriptor lookupscountfile
falco.scap.n.noncached.thread.lookups.countTotal number of non-cached thread lookupscount-
falco.scap.n.removed.fds.countTotal number of file descriptors removed from internal tracking tablescountfile
falco.scap.n.removed.threads.countTotal number of threads removed from internal tracking tablescountthread
falco.scap.n.retrieve.evts.drops.countTotal number of events dropped during retrieval processcount-
falco.scap.n.retrieved.evts.countTotal number of events successfully retrieved from kernelcount-
falco.scap.n.store.evts.drops.countTotal number of events dropped during storage processcount-
falco.scap.n.stored.evts.countTotal number of events successfully storedcount-
falco.scap.n.threadsCurrent number of threads stored in internal tracking tablesgaugethread
falco.sha256.config.filesSHA256 hash information of Falco configuration filesgauge-
falco.sha256.rules.filesSHA256 hash information of Falco rules filesgauge-

Official documentation

Official documentation for the Falco integration

Metric names and descriptions are the official Datadog integration definitions (Copyright Datadog, Inc., BSD-3-Clause), reproduced unedited. The full license terms are on the About page.