RRDFIRST(1)

📦
version 1.11.0 · 13 versions
, in arch rolling

okay so bestie, welcome to RRDFIRST(1) — the rrdfirst page from the rrdtool manual, section 1. She’s short, she’s useful, she’s giving tiny-but-mighty utility energy. 💅

🌸 NAME 🌸

rrdfirst — return the date of the first data sample in an RRA within an RRD. No cap, that’s the whole gig. ✨

🦋 SYNOPSIS 🦋

rrdtool first filename [--rraindex number] [--daemon|-d address]

💖 DESCRIPTION 💖

The first function returns the UNIX timestamp of the first data sample entered into the specified RRA of the RRD file. That’s it, that’s the magic. 🎀

  • filename — the name of the RRD that contains the data. Like, point her at the file and she’ll do her thing. 🗂️
  • --rraindex number — the index number of the RRA that is to be examined. If not specified, the index defaults to zero. RRA index numbers can be determined through rrdtool info. Slay, now you can find the right one. 🔍
  • --daemon|-d address — address of the rrdcached daemon. For a list of accepted formats, see the -l option in the rrdcached manual. iykyk. 🧚

Example time, because we love a concrete demo:

rrdtool first --daemon unix:/var/run/rrdcached.sock /var/lib/rrd/foo.rrd

👑 AUTHOR 👑

  • Burton Strauss <Burton@ntopSupport.com> — author energy. 💜
  • Daemon support added by Steve Shipway <steve@steveshipway.org> — and yes, the daemon support is his whole moment. 🫶

aaaand that’s the page, bestie. This footer-adjacent cutie is version 1.11.0, dated 2026-10-17, and the rrdtool manual says periodt. 💅✨

📦 where this page comes from