https://github.com/marekq/go-nextdns

Stream and download NextDNS logs
https://github.com/marekq/go-nextdns

golang nextdns

Last synced: about 6 hours ago
JSON representation

Stream and download NextDNS logs

• Host: GitHub
• URL: https://github.com/marekq/go-nextdns
• Owner: marekq
• License: mit
• Created: 2022-09-06T18:51:04.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-07-31T21:13:19.000Z (6 months ago)
• Last Synced: 2025-01-09T23:24:37.553Z (6 days ago)
• Topics: golang, nextdns
• Language: Go
• Homepage:
• Size: 17.6 KB
• Stars: 6
• Watchers: 1
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

        
go-nextdns

==========

Stream and download logs from your NextDNS account. This project is experimental and may contain bugs. 

In current form, it's useful for simple debugging and logging of DNS activity on your local network. You could run the `stream` command during debugging, or use the `download` command to download logs locally. 

## Getting started

 

Follow these steps to get started:

- Copy `example.env` to `.env` and fill in your NextDNS profile and API key. You can retrieve these from the [NextDNS portal](https://my.nextdns.io/d8c532/setup).

- Make sure you have `golang` installed locally. On Mac, you can install it using `brew install golang`. 

- Run `go build` to build the executable locally. 

- Finally, test using `./nextdns stream` to stream all logs.

The stream and download logs are stored in your local directory. You can monitor these in realtime running `tail -f `.

## Example commands for CLI:

### Stream all logs

- `./nextdns stream`

### Stream logs with a specific keyword

- `./nextdns stream coldstart.dev`

### Download logs from last 6 hours

- `./nextdns download -6h now`

### Download logs between a start and end date

- `./nextdns download 2022-09-01 2022-09-05`