RRDFIRST(1) rrdtool RRDFIRST(1)

# [NAME](#NAME)

rrdfirst - Return the date of the first data sample in an RRA within an RRD

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#DESCRIPTION)

The **first** function returns the UNIX timestamp of the first data sample entered into the specified RRA of the RRD file.

[*filename*](#filename)

The name of the **RRD** that contains the data.

[**--rraindex** *number*](#rraindex)

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**.

[**--daemon**|**-d** *address*](#daemon)

Address of the rrdcached daemon. For a list of accepted formats, see the **-l** option in the rrdcached manual.

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

# [AUTHOR](#AUTHOR)

Burton Strauss <Burton@ntopSupport.com> Daemon support added by Steve Shipway <steve@steveshipway.org>

2026-09-01 1.11.0

---

Document: rrdfirst(1) from rrdtool 1.11.0-r1 (Chainguard OS)
Source: https://github.com/oetiker/rrdtool-1.x