Skip to content

About

hyperglass is the network looking glass that tries to make the internet better.

Resources

Code of conduct

Contributing

Stars

12 stars

Watchers

1 watching

Forks

 
 

Repository files navigation



The network looking glass that tries to make the internet better.


A looking glass is implemented by network operators as a way of providing customers, peers, or the general public with a way to easily view elements of, or run tests from the provider's network.

Important

hyperglass-ng has moved back upstream

This fork is archived and no longer receives updates. Development continues at hyperglass-community/hyperglass, the new home of hyperglass after Matt Love handed the project over. I'm now one of its maintainers, so the work that went into hyperglass-ng continues there.

What this means for you

  • Issues and pull requests: please open them on hyperglass-community/hyperglass.
  • Container images: ghcr.io/jsenecal/hyperglass-ng images stay available but won't be updated. Upstream publishes ghcr.io/hyperglass-community/hyperglass from version tags. 3.0.0 is currently a release candidate.
  • Upgrading: follow upstream's upgrade guide. The hyperglass package, CLI, HYPERGLASS_* environment variables and /etc/hyperglass layout are the same.

Where hyperglass-ng's changes went

  • Already upstream: cgroup-aware worker count, the command-injection fix for #383 (reimplemented upstream), the SSH transport integration test, and the Renovate configuration.
  • In review upstream: HTTP 400 for invalid queries (#412), exact query-type resolution (#426), and a consistent BGP origin AS (#459).
  • Still to be proposed upstream: /api/health and Prometheus metrics, shareable result links, and per-browser query history.

Thanks to everyone who used, tested and contributed to hyperglass-ng.


Documentation   |   Live Demo

Frontend Tests Backend Tests


hyperglass is intended to make implementing a looking glass too easy not to do, with the lofty goal of improving the internet community at large by making looking glasses more common across autonomous systems of any size.

Features

  • BGP Route, BGP Community, BGP AS Path, Ping, & Traceroute, or add your own commands.
  • Full IPv6 support
  • Customizable everything: features, theme, UI/API text, error messages, commands
  • Built-in support for:
    • Arista EOS
    • BIRD
    • Cisco IOS
    • Cisco NX-OS
    • Cisco IOS-XR
    • FRRouting
    • Huawei VRP
    • Juniper Junos
    • Mikrotik
    • Nokia SR OS
    • OpenBGPD
    • TNSR
    • VyOS
  • Configurable support for any other supported platform
  • Optionally access devices via an SSH proxy/jump server
  • Access-list/prefix-list style query control to whitelist or blacklist query targets
  • REST API with automatic, configurable OpenAPI documentation
  • Modern, responsive UI built on ReactJS, with NextJS & Chakra UI, written in TypeScript
  • Query multiple devices simultaneously
  • Browser-based DNS-over-HTTPS resolution of FQDN queries

To request support for a specific platform, please submit a Github Issue with the feature label.

Community

Any users, potential users, or contributors of hyperglass are welcome to join and discuss usage, feature requests, bugs, and other things.

hyperglass is developed with the express intention of being free to the networking community.

However, if you're feeling particularly helpful or generous, small donations are welcome.

Donate

Acknowledgements

hyperglass is built entirely on open-source software. Here are some of the awesome libraries used, check them out too!

GitHub

About

hyperglass is the network looking glass that tries to make the internet better.

Resources

Code of conduct

Contributing

Stars

12 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages