feat: dynamic selectors with alert_foreign_logs_enricher (#1600)

* feat: dynamic selectors with alert_foreign_logs_enricher

* feat: improve label parsing fallback and add documentation

* test: small tweaks to unit test

* fix: improve selector test and fix incorrect parsing issue

* test: reenable commented out tests

* chore: refactor locator parsing code

* fix: incorrect import in playbooks and update docs

* fix: revert some unnecessary changes to documentation generation

* fix: restore unechanged files

Author: nherment

docs/playbook-reference/actions/event-enrichment.rst

@@ -128,6 +128,21 @@ These actions enrich Prometheus alerts and only support the :ref:`on_prometheus_
 
 .. robusta-action:: playbooks.robusta_playbooks.alerts_integration.foreign_logs_enricher
 
+.. robusta-action:: playbooks.robusta_playbooks.alerts_integration.alert_foreign_logs_enricher
+
+    Here is an example using a dynamic selector that depends on the alert's labels
+
+    .. code-block:: yaml
+
+        customPlaybooks:
+        - actions:
+            - alert_foreign_logs_enricher:
+                label_selectors:
+                - "app=${labels.service}"
+                - "env=production"
+        triggers:
+          - on_prometheus_alert: {}
+
 .. robusta-action:: playbooks.robusta_playbooks.alerts_integration.alert_definition_enricher
 
 .. robusta-action:: playbooks.robusta_playbooks.alerts_integration.mention_enricher

playbooks/robusta_playbooks/alerts_integration.py

@@ -455,6 +455,20 @@ class ForeignLogParams(LogEnricherParams):
     title_override: Optional[str]
 
 
+@action
+def alert_foreign_logs_enricher(event: PrometheusKubernetesAlert, params: ForeignLogParams):
+    """
+    Prometheus alert enricher to fetch and attach pod logs.
+
+    This action behaves the same as the foreign_logs_enricher.
+    The logs are fetched for the pod determined by the label selector field in the parameters.
+    The label selector field can use the format ${labels.XYZ} to reference any XYZ label present in the Prometheus alert.
+
+    """
+    subject = event.get_subject()
+    params.label_selectors = [format_event_templated_string(subject, selector) for selector in params.label_selectors]
+    return foreign_logs_enricher(event, params)
+
 @action
 def foreign_logs_enricher(event: ExecutionBaseEvent, params: ForeignLogParams):
     """