{"id":4367,"date":"2022-03-03T15:27:16","date_gmt":"2022-03-03T21:27:16","guid":{"rendered":"https:\/\/www.incredigeek.com\/home\/?p=4367"},"modified":"2023-02-08T15:35:07","modified_gmt":"2023-02-08T21:35:07","slug":"setting-up-grafana-on-librenms","status":"publish","type":"post","link":"https:\/\/www.incredigeek.com\/home\/setting-up-grafana-on-librenms\/","title":{"rendered":"Setting up Grafana on LibreNMS"},"content":{"rendered":"\n

<\/p>\n\n\n\n

Thanks to the guys who put together the information at the following links. <\/p>\n\n\n\n

https:\/\/wadman.co.nz\/2021\/01\/02\/Viewing-LibreNMS-data-in-Grafana\/<\/a>
https:\/\/www.reddit.com\/r\/LibreNMS\/comments\/ojc8cc\/how_to_almost_natively_integrate_librenms_and\/<\/a><\/p>\n\n\n\n

I ran into some issues trying to get this to work. So here are some of my notes. I already had a LibreNMS installation set up. <\/p>\n\n\n\n

<\/p>\n\n\n\n

    \n
  1. Install RRDReST\n
      \n
    1. Install Docker<\/li>\n\n\n\n
    2. Configure Docker compose file<\/li>\n<\/ol>\n<\/li>\n\n\n\n
    3. Configure LibreNMS API User and Key<\/li>\n\n\n\n
    4. Set up and Configure Grafana\n
        \n
      1. Install Grafana<\/li>\n\n\n\n
      2. Install JSON Data Source Plugin<\/li>\n\n\n\n
      3. Add LibreNMS API Data Source<\/li>\n\n\n\n
      4. Add RRDReST Data Source<\/li>\n\n\n\n
      5. Import Dashboard into Grafana<\/li>\n<\/ol>\n<\/li>\n\n\n\n
      6. View graphs<\/li>\n<\/ol>\n\n\n\n

        <\/p>\n\n\n\n

        Installing RRDReST<\/h1>\n\n\n\n

        NOTE FOR CENTOS 8, ALMALINUX 8 and 9
        The steps for installing RRDReST are slightly different. Check out the following post.
        https:\/\/www.incredigeek.com\/home\/setting-up-rrdrest-on-centos-8-or-almalinux-9\/<\/a><\/p>\n\n\n\n

        I had issues installing RRDReST. I am guessing it had to do with it accessing files. I was able to install it in a docker container. <\/p>\n\n\n\n

          \n
        1. Install Docker<\/li>\n\n\n\n
        2. Create a compose file<\/li>\n\n\n\n
        3. Install container<\/li>\n<\/ol>\n\n\n\n

          Install docker<\/h2>\n\n\n\n
          sudo yum install -y docker docker-compose
          sudo systemctl enable docker<\/pre>\n\n\n\n
          Create docker compose file with the following options<\/p>\n\n\n\n
          vi docker-compose.yml<\/pre>\n\n\n\n
          Change the TZ to your time zone.  If you have issues with the graphs, most likely something is off with the time zone between this container and Grafana\/LibreNMS server<\/p>\n\n\n\n
          version: \"3.5\"\n\nservices:\n\n  rrdrest:\n    image: michaelwadman\/rrdrest:latest\n    container_name: rrdrest\n    restart: always\n    volumes:\n      - \"\/opt\/librenms:\/opt\/librenms\"\n    environment:\n      - TZ=America\/Denver<\/pre>\n\n\n\n
          Save the file and start and setup the container with <\/p>\n\n\n\n
          sudo docker-compose up -d<\/pre>\n\n\n\n
          You will need your docker container IP address to setup the connection in Grafana<\/p>\n\n\n\n
          sudo docker exec -it rrdrest ip addr | grep eth0<\/pre>\n\n\n\n
          Congratulations.  You should now have a RRDReST docker container that will auto start on system boot and has the correct time zone.<\/p>\n\n\n\n
          <\/p>\n\n\n\n
          <\/p>\n\n\n\n
          Configure LibreNMS API User and Key<\/h1>\n\n\n\n
            \n
          1. Create a Grafana user in LibreNMS. (Settings Gear -> Manage Users -> Add Users)
            You could technically skip this step and use an existing user.<\/em><\/li>\n\n\n\n
          2. Create API token for the newly created user (Setting Gear -> API -> API Settings)<\/li>\n<\/ol>\n\n\n\n
            \"\"<\/a>
            Create a Grafana user in LibreNMS<\/figcaption><\/figure>\n\n\n\n
            \"\"<\/a>
            Setup API Key for Grafana in LibreNMS<\/figcaption><\/figure>\n\n\n\n
            <\/p>\n\n\n\n
            Set up and Configure Grafana<\/h1>\n\n\n\n
            Basic steps are as follows<\/p>\n\n\n\n
              \n
            1. Install Grafana<\/li>\n\n\n\n
            2. Install JSON Data Source Plugin<\/li>\n\n\n\n
            3. Configure Data Sources\n
                \n
              1. LibreNMS API<\/li>\n\n\n\n
              2. RRDRest API<\/li>\n<\/ol>\n<\/li>\n\n\n\n
              3. Import Dashboard into Grafana<\/li>\n<\/ol>\n\n\n\n
                <\/p>\n\n\n\n
                \n
                Install Grafana <\/h2>\n\n\n\n
                There is not anything special with installing Grafana on the same server as LibreNMS.  You can follow the official guide to install it <\/p>\n\n\n\n
                https:\/\/grafana.com\/docs\/grafana\/latest\/installation\/<\/a><\/p>\n\n\n\n
                After Grafana is installed, install the JSON API<\/a> data source.  You can do this using the grafana-cli<\/p>\n\n\n\n
                grafana-cli plugins install marcusolsson-json-datasource<\/pre>\n\n\n\n
                A note on SSL\/TLS certificates.  If you have an SSL certificate for LibreNMS, you can use it for grafana.  If you run into issues, try copying the cert (fullchain.pem, privkey.pem) to \/etc\/grafana\/<\/em><\/p>\n\n\n\n
                You’ll most likely need to change owner<\/em><\/p>\n\n\n\n
                sudo chown root:grafana \/etc\/grafana\/*.pem<\/pre>\n\n\n\n
                And maybe the file permissions.<\/em><\/p>\n\n\n\n
                sudo chmod 640 \/etc\/grafana\/*.pem<\/pre>\n<\/div><\/div>\n\n\n\n
                <\/p>\n\n\n\n
                \n
                Install JSON Data Source Plugin<\/h2>\n\n\n\n
                This is fairly straight forward.<\/p>\n\n\n\n
                grafana-cli plugins install marcusolsson-json-datasource<\/pre>\n<\/div><\/div>\n\n\n\n
                <\/p>\n\n\n\n
                \n
                Add LibreNMS API Data Source<\/h2>\n\n\n\n
                In Grafana, go to Configuration -> Data Sources -> Add data source<\/p>\n\n\n\n