Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/slaveofcode/nsqtracer

Simple NSQ tracer tool to see any messages that being published to specific NSQ topic
https://github.com/slaveofcode/nsqtracer

cli cli-tool cli-utilities nsq nsqd nsqlookup

Last synced: about 8 hours ago
JSON representation

Simple NSQ tracer tool to see any messages that being published to specific NSQ topic

Host: GitHub
URL: https://github.com/slaveofcode/nsqtracer
Owner: slaveofcode
License: mit
Created: 2020-10-20T09:21:00.000Z (about 4 years ago)
Default Branch: main
Last Pushed: 2020-10-26T05:02:36.000Z (about 4 years ago)
Last Synced: 2024-06-19T11:16:39.208Z (5 months ago)
Topics: cli, cli-tool, cli-utilities, nsq, nsqd, nsqlookup
Language: Go
Homepage:
Size: 85 KB
Stars: 7
Watchers: 4
Forks: 1
Open Issues: 1
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

# NSQTracer
Simple NSQ tracer tool to see any messages that being published to specific NSQ `topic`. This library will not consume the message, only listening for new messages and display, that's it. However it also can consume the message by providing `--auto-finish` option, so the message will be assumed as finished.

### Installation
Simply go to the [latest binary release](https://github.com/slaveofcode/nsqtracer/releases) page to download the binary, and then run via CLI command. or if you has Go installed locally, NSQTracer can be installed via `go install`

**Tips:**
Place the binary on `/usr/local/bin` (for *\*nix* users) so it accessible anywhere in your system.

```
$ go install github.com/slaveofcode/nsqtracer
```

#### Start from default address
```
$ ./nsqtracer --topic SOMETOPIC
```

The command above will start a tracer listening from default `nsqd` host address, which is located on `localhost:4151`.

#### Start from specific address
If you want to use specific address of NSQd, you can attach more options like below

```
$ ./nsqtracer --topic SOMETOPIC --nsqd-tcp localhost:4180
```

#### Start from multiple address
NSQTracer is able to listen from multiple `nsqd` addresses, so you can watch through all `nsqd` instances. Simply add more on the `--nsqd-tcp` options.

```
$ ./nsqtracer --topic SOMETOPIC --nsqd-tcp localhost:4150 --nsqd-tcp localhost:4140 --nsqd-tcp localhost:4180
```

### Using NSQLookupd address
By using `nsqlookupd` host address you'll discover all `nsqd`'s that connected to the `nsqlookupd` instance, it's really helpful when you want to listen from all `nsqd`'s by supplying only one `nsqlookupd` http address.

```
$ ./nsqtracer --topic SOMETOPIC --nsqlookup-http localhost:4161
```

The same rule applies for the `--nsqlookup-http` option, you can also provide more than one `nsqlookupd` addresses.

#### Read Available Options
Just run `./nsqtracer --help` to see all available commands

### LICENSE
MIT License