rust-libp2p

mirror of https://github.com/fluencelabs/rust-libp2p synced 2025-04-25 19:02:13 +00:00

History

feat(libp2p): add SwarmBuilder

Introduce the new `libp2p::SwarmBuilder`. Users should use the new `libp2p::SwarmBuilder` instead of the now deprecated `libp2p::swarm::SwarmBuilder`. See `libp2p::SwarmBuilder` docs on how to use the new builder.

Fixes #3657.
Fixes #3563.
Fixes #3179.

Pull-Request: #4120.

2023-10-10 06:55:14 +00:00

src

feat(libp2p): add SwarmBuilder

2023-10-10 06:55:14 +00:00

Cargo.toml

ci: use workspace inheritance to enforce lints in all crates

2023-10-09 02:20:46 +00:00

README.md

docs(examples): add a README to each example

2023-06-01 07:40:22 +00:00

README.md

Description

The example showcases how to run a p2p network with libp2p and collect metrics using libp2p-metrics. It sets up multiple nodes in the network and measures various metrics, such as libp2p_ping, to evaluate the network's performance.

Usage

To run the example, follow these steps:

Run the following command to start the first node:
```
cargo run
```
Open a second terminal and run the following command to start a second node:
```
cargo run -- <listen-addr-of-first-node>
```
Replace <listen-addr-of-first-node> with the listen address of the first node reported in the first terminal. Look for the line that says NewListenAddr to find the address.
Open a third terminal and run the following command to retrieve the metrics from either the first or second node:
```
curl localhost:<metrics-port-of-first-or-second-node>/metrics
```
Replace <metrics-port-of-first-or-second-node> with the listen port of the metrics server of either the first or second node. Look for the line that says tide::server Server listening on to find the port.

After executing the command, you should see a long list of metrics printed to the terminal. Make sure to check the libp2p_ping metrics, which should have a value greater than zero (>0).

Conclusion

This example demonstrates how to utilize the libp2p-metrics crate to collect and analyze metrics in a libp2p network. By running multiple nodes and examining the metrics, users can gain insights into the network's performance and behavior.