Экспериментальная версия. Функциональность может сильно измениться. Совместимость с будущими версиями не гарантируется.

Включение логов для отладки

Falco

По умолчанию используется уровень логирования debug.

Falcosidekick

По умолчанию отладочное логирование выключено в Falcosidekick.

Для включения отладочного логирования установите параметр spec.settings.debugLogging в true:

1apiVersion: deckhouse.io/v1alpha1
2kind: ModuleConfig
3metadata:
4  name: runtime-audit-engine
5spec:
6  enabled: true
7  settings:
8    debugLogging: true

Просмотр метрик

Для получения метрик можно использовать PromQL-запрос falcosecurity_falcosidekick_falco_events_total{}:

1kubectl -n d8-monitoring exec -it prometheus-main-0 prometheus -- \
2  curl -s "http://127.0.0.1:9090/api/v1/query?query=falcosecurity_falcosidekick_falco_events_total" | jq

В будущем мы добавим Grafana dashboard для просмотра метрик.

Эмуляция события Falco

Вы можете использовать утилиту event-generator для генерации событий Falco.

event-generator может генерировать различные подозрительные действия (syscalls, k8s audit events и др.).

Вы можете использовать следующую команду для запуска тестового набора событий в кластере Kubernetes:

1kubectl run falco-event-generator --image=falcosecurity/event-generator run

Если вам нужно реализовать действие, воспользуйтесь руководством.

Эмуляция события Falcosidekick

Вы можете использовать Falcosidekick /test HTTP endpoint для отправки тестового события.

  • Создайте отладочное событие, выполнив команду:

    1nsenter -t $(pidof falcosidekick) curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" http://localhost:2801/test
    
  • Проверьте метрику отладочного события:

    1kubectl -n d8-monitoring exec -it prometheus-main-0 prometheus -- \
    2  curl -s "http://127.0.0.1:9090/api/v1/query?query=falcosecurity_falcosidekick_falco_events_total" \
    3  | jq '.data.result.[] | select (.metric.priority_raw == "debug")'
    
  • Пример вывода:

    1{
    2  "metric": {
    3    "__name__": "falcosecurity_falcosidekick_falco_events_total",
    4    "container": "kube-rbac-proxy",
    5    "hostname": "falcosidekick",
    6    "instance": "192.168.208.7:4212",
    7    "job": "runtime-audit-engine",
    8    "node": "dev-master-0",
    9    "priority": "1",
    10    "priority_raw": "debug",
    11    "rule": "Test rule",
    12    "source": "internal",
    13    "tier": "cluster"
    14  },
    15  "value": [
    16    1744234729.799,
    17    "1"
    18  ]
    19}