docs(configuration): inline PFCP dump examples into config_upf and remove separate file

Signed-off-by: Arnav Kapoor <[email protected]>

Author: arnavk23

configuration/config_upf.rst

@@ -10,7 +10,63 @@ Below you may find some of the upf override configuration.
 Bess default values `can be found here <https://github.com/omec-project/sdcore-helm-charts/blob/main/bess-upf/values.yaml>`_
 
 For an example of enabling PFCP raw-dump (values.yaml snippets) for the
-``pfcp-agent`` see :doc:`pfcp-dump-examples`.
+``pfcp-agent`` see the "PFCP Dump Examples" section below.
+
+
+PFCP Dump Examples
+------------------
+
+This file contains example ``values.yaml`` snippets to enable the PFCP raw-dump
+feature for debugging parse errors in the ``pfcp-agent`` container.
+
+
+Use transient storage (empty dir)
+--------------------------------------------------
+
+.. code-block:: yaml
+
+  upfDump:
+    enabled: true
+    dir: /var/log/upf/pfcp_dumps
+    upfName: my-upf-instance
+    maxBytes: 104857600  # 100 MiB total per-instance
+    maxFiles: 1000
+    toLog: false
+    persistence:
+      enabled: false
+
+This will mount an ``emptyDir`` into the pod at ``/var/log/upf/pfcp_dumps`` and
+the runtime will prune files when the directory exceeds ``maxBytes`` or
+``maxFiles``.
+
+Use persistent storage (PVC)
+-----------------------------------------------
+
+.. code-block:: yaml
+
+  upfDump:
+    enabled: true
+    dir: /var/log/upf/pfcp_dumps
+    upfName: upf-01
+    maxBytes: 1073741824  # 1 GiB
+    maxFiles: 10000
+    toLog: false
+    persistence:
+      enabled: true
+      size: 10Gi
+      storageClass: fast-ssd
+
+This configuration will cause the chart to create a PersistentVolumeClaim named
+``<release>-pfcp-dump-pvc`` and mount it into the ``pfcp-agent`` container at
+the configured ``dir``.
+
+Notes
+-----
+
+- ``maxBytes`` and ``maxFiles`` are enforced by the UPF process (pruning).
+  Set either to ``0`` to disable that limit.
+- ``toLog=true`` will also emit base64-encoded dumps to application logs — be
+  careful in high-throughput environments.
 
 UPF Address Pool
 -----------------

index.rst

@@ -70,7 +70,6 @@ can be found on the `SD-Core Wiki
    configuration/config_rest.rst
    configuration/config_simapp.rst
    configuration/application_filtering.rst
-   configuration/pfcp-dump-examples.rst
    configuration/qos_config.rst
    configuration/config_upf.rst