Ingest New Documentation (#2842)

Co-authored-by: netdatabot <43409846+netdatabot@users.noreply.github.com>

Author: github-actions[bot]

docs/Collecting Metrics/Collectors/Networking/SNMP devices.mdx

@@ -450,6 +450,53 @@ Network interface metrics from cached SNMP data, including traffic rates, packet
 | Multicast In | float | packets/s | hidden | Rate of multicast packets (destined for a group) received per second. Common in video streaming, multicast applications, and routing protocols. |
 | Multicast Out | float | packets/s | hidden | Rate of multicast packets transmitted per second. |
 
+### Network Topology
+
+Provides the agent-wide SNMP topology view built from all currently running topology-enabled SNMP jobs.
+
+This function reads cached LLDP/CDP data collected by the independent topology refresh loop and returns a topology schema (devices, links, and stats). No additional SNMP requests are triggered when calling this function.
+
+Use cases:
+- Discover Layer 2 neighbors and link mapping
+- Validate cabling and port connections
+- Identify adjacent devices that are discovered but not monitored
+
+
+| Aspect | Description |
+|:-------|:------------|
+| Name | `Snmp:topology` |
+| Require Cloud | no |
+| Performance | Uses cached SNMP data only, no additional SNMP requests are triggered:<br/>• Responses are instantaneous from memory cache<br/>• Large devices with many discovered neighbors may return many rows |
+| Security | Exposes discovered device identifiers, interface/port identifiers, and management addresses only:<br/>• No packet payloads or authentication credentials are exposed<br/>• No device configuration details are exposed |
+| Availability | Available when:<br/>• The collector has completed at least one successful topology refresh cycle<br/>• LLDP/CDP topology data is present in cache from the last successful topology refresh<br/>• Returns HTTP 503 if topology cache is not ready yet |
+
+#### Prerequisites
+
+No additional configuration is required.
+
+#### Parameters
+
+| Parameter | Type | Description | Required | Default | Options |
+|:---------|:-----|:------------|:--------:|:--------|:--------|
+| Nodes Identity | select | Choose actor identity strategy. `ip` collapses nodes by management IP and removes non-IP inferred actors. `mac` keeps MAC-oriented identities. | yes | ip | IP (default), MAC |
+| Map | select | Select the topology map mode. Defaults to the managed-device LLDP/CDP view. Other modes progressively include inferred devices and lower-confidence links. | yes | lldp_cdp_managed | LLDP/CDP/Managed Devices Map (default), High Confidence Inferred Map, All Devices (Low Confidence) |
+| Infer Strategy | select | Select the inference algorithm used for FDB/STP/CDP correlation. | yes | fdb_minimum_knowledge | FDB Minimum-Knowledge (Baseline) (default), STP Parent Tree, FDB Pairwise Minimum-Knowledge, STP + FDB Correlated, CDP + FDB Hybrid |
+| Focus On | multiselect | Limit depth filtering to selected managed SNMP roots. The static default is `all_devices`; additional `ip:<address>` options are supplied dynamically from the current managed SNMP jobs. | yes | all_devices | All Devices (default) |
+| Focus Depth | select | Limit topology expansion hops from the focus roots. `all` disables depth filtering. | yes | all | All (default), 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 |
+
+#### Returns
+
+Agent-wide topology data in a JSON schema suitable for cross-agent aggregation.
+
+| Column | Type | Unit | Visibility | Description |
+|:-------|:-----|:-----|:-----------|:------------|
+| schema_version | integer |  |  | Topology schema version. |
+| agent_id | string |  |  | Netdata Agent or vnode identifier that collected the data. |
+| collected_at | string |  |  | Collection timestamp in RFC 3339 format. |
+| devices | array |  |  | List of devices (local and discovered). |
+| links | array |  |  | List of discovered links (LLDP/CDP). |
+| stats | object |  |  | Summary stats (device/link counts). |
+
 
 
 ## Troubleshooting

docs/Collecting Metrics/SNMP Profile Format.mdx

@@ -1256,6 +1256,7 @@ They work the same in **both** places:
 
 | Transformation                   | Purpose                                         | Example Input → Output                                           |
 |----------------------------------|-------------------------------------------------|------------------------------------------------------------------|
+| `format`                         | Convert the raw SNMP value before tag parsing.  | `0x18fd74331a9c → "18fd74331a9c"`                                |
 | `mapping`                        | Replace numeric/string codes with names.        | `1 → "ethernet"`, `161 → "lag"`                                  |
 | `extract_value`                  | Extract a substring via regex (first group).    | `"RouterOS CCR2004-16G-2S+" → "CCR2004-16G-2S+"`                 |
 | `match_pattern` + `match_value`  | Replace the value using regex groups or static. | `"Palo Alto Networks VM-Series firewall" → "VM-Series firewall"` |
@@ -1302,6 +1303,50 @@ They work the same in **both** places:
       port: $4
     ```
 
+- `format`
+    ```yaml
+    symbol:
+      OID: 1.3.6.1.2.1.17.1.1
+      name: dot1dBaseBridgeAddress
+      format: hex
+    ```
+
+### Format
+
+Use `format` when the raw SNMP value must be converted before tag or metadata processing.
+
+**The collector**:
+
+- Applies `format` when converting the raw SNMP value to a string.
+- Then applies the configured tag or metadata transformations to that formatted string.
+- Supports the same `format` values accepted by `symbol` definitions elsewhere in the profile.
+
+**Where it can be used**:
+
+- `metadata.device.fields.<field>.symbol`
+- `metadata.device.fields.<field>.symbols[]`
+- `metric_tags[].symbol`
+
+**Currently used by this profile set**:
+
+- `format: hex` for octet-string values such as:
+  - MAC addresses
+  - binary management-address values
+  - capability bitmaps
+
+**Example**:
+
+```yaml
+metadata:
+  device:
+    fields:
+      bridge_base_address:
+        symbol:
+          OID: 1.3.6.1.2.1.17.1.1
+          name: dot1dBaseBridgeAddress
+          format: hex
+```
+
 ### Mapping
 
 Use `mapping` to replace raw tag values with **human-readable text labels**.

docs/Developer and Contributor Corner/External Plugins/External Plugins.mdx

@@ -172,6 +172,7 @@ available for the plugin to use.
 |:--------------------------------:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 |    `NETDATA_USER_CONFIG_DIR`     | The directory where all Netdata-related user configuration should be stored. If the plugin requires custom user configuration, this is the place the user has saved it (normally under `/etc/netdata`).                                                |
 |    `NETDATA_STOCK_CONFIG_DIR`    | The directory where all Netdata -related stock configuration should be stored. If the plugin is shipped with configuration files, this is the place they can be found (normally under `/usr/lib/netdata/conf.d`).                                      |
+|     `NETDATA_STOCK_DATA_DIR`     | The directory where immutable Netdata stock data files are stored. Plugins can use this for packaged data assets such as MMDB files (normally under `/usr/share/netdata`).                                                                            |
 |      `NETDATA_PLUGINS_DIR`       | The directory where all Netdata plugins are stored.                                                                                                                                                                                                    |
 |   `NETDATA_USER_PLUGINS_DIRS`    | The list of directories where custom plugins are stored.                                                                                                                                                                                               |
 |        `NETDATA_WEB_DIR`         | The directory where the web files of Netdata are saved.                                                                                                                                                                                                |

docs/Developer and Contributor Corner/Redistributed Software.mdx

@@ -30,6 +30,8 @@ We have decided to redistribute all these, instead of using them through a CDN,
 | [xxHash](https://github.com/Cyan4973/xxHash)                            | Copyright (c) 2012-2021 Yann Collet                                                | [BSD](https://github.com/Cyan4973/xxHash/blob/dev/LICENSE)                               |
 | [Judy Arrays](https://sourceforge.net/projects/judy/)                   | Copyright (C) 2000 - 2002 Hewlett-Packard Company                                  | [LGPLv2](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html)                     |
 | [dlib](https://github.com/davisking/dlib/)                              | Copyright (C) 2019  Davis E. King (davis@dlib.net), Nils Labugt                    | [Boost Software License](https://github.com/davisking/dlib/blob/master/dlib/LICENSE.txt) |
+| [DB-IP ASN Lite](https://db-ip.com/db/download/ip-to-asn-lite)          | DB-IP.com                                                                          | [CC BY 4.0](https://db-ip.com/db/lite.php)                                                |
+| [DB-IP City Lite](https://db-ip.com/db/download/ip-to-city-lite)        | DB-IP.com                                                                          | [CC BY 4.0](https://db-ip.com/db/lite.php)                                                |
 
 ---
 

docs/Netdata Agent/Configuration/Daemon.mdx

@@ -153,6 +153,7 @@ The multiplication of all the **enabled** tiers `dbengine tier N update every it
 |:-------------------:|:------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 |       config        |                           `/etc/netdata`                           | The directory configuration files are kept.                                                                                                                                        |
 |    stock config     |                     `/usr/lib/netdata/conf.d`                      |                                                                                                                                                                                    |
+|     stock data      |                      `/usr/share/netdata`                          | The directory Netdata uses for immutable stock data files shipped with the installation.                                                                                           |
 |         log         |                         `/var/log/netdata`                         | The directory in which the [log files](/docs/netdata-agent/daemon#logging) are kept.                                                                                                    |
 |         web         |                      `/usr/share/netdata/web`                      | The directory the web static files are kept.                                                                                                                                       |
 |        cache        |                        `/var/cache/netdata`                        | The directory the memory database will be stored if and when Netdata exits. Netdata will re-read the database when it will start again, to continue from the same point.           |