Skip to content

2nd July 2023

Coding

Languages

Promql

  • New: Run operation only on the elements that match a condition.

    Imagine we want to run the zfs_dataset_used_bytes - zfs_dataset_used_by_dataset_bytes operation only on the elements that match zfs_dataset_used_by_dataset_bytes > 200e3. You can do this with and:

    zfs_dataset_used_bytes - zfs_dataset_used_by_dataset_bytes and zfs_dataset_used_by_dataset_bytes > 200e3
    
  • New: Substracting two metrics.

    To run binary operators between vectors you need them to match. Basically it means that it will only do the operation on the elements that have the same labels. Sometimes you want to do operations on metrics that don't have the same labels. In those cases you can use the on operator. Imagine that we want to substract the next vectors:

    zfs_dataset_used_bytes{type='filesystem'}
    

    And

    sum by (hostname,filesystem) (zfs_dataset_used_bytes{type='snapshot'})
    

    That only have in common the labels hostname and filesystem`.

    You can use the next expression then:

    zfs_dataset_used_bytes{type='filesystem'} - on (hostname, filesystem) sum by (hostname,filesystem) (zfs_dataset_used_bytes{type='snapshot'})
    

    To learn more on Vector matching read this article

  • New: Ranges only allowed for vector selectors.

    You may need to specify a subquery range such as [1w:1d].

Python Snippets

  • New: Sort the returned paths of glob.

    glob order is arbitrary, but you can sort them yourself.

    If you want sorted by name:

    sorted(glob.glob('*.png'))
    

    sorted by modification time:

    import os
    sorted(glob.glob('*.png'), key=os.path.getmtime)
    

    sorted by size:

    import os
    sorted(glob.glob('*.png'), key=os.path.getsize)
    

DevOps

Infrastructure as Code

Ansible Snippets

  • New: Start and enable a systemd service.

    - name: Start the service
      become: true
      systemd:
        name: zfs_exporter
        enabled: true
        daemon_reload: true
        state: started
    
  • New: Download an decompress a tar.gz.

    - name: Unarchive a file that needs to be downloaded (added in 2.0)
      ansible.builtin.unarchive:
        src: https://example.com/example.zip
        dest: /usr/local/bin
        remote_src: yes
    

    If you want to only extract a file you can use the includes arg

    - name: Download the zfs exporter
      become: true
      ansible.builtin.unarchive:
        src: https://github.com/pdf/zfs_exporter/releases/download/v{{ zfs_exporter_version }}/zfs_exporter-{{ zfs_exporter_version }}.linux-amd64.tar.gz
        dest: /usr/local/bin
        include: zfs_exporter
        remote_src: yes
        mode: 0755
    

    But that snippet sometimes fail, you can alternatively download it locally and copy it:

    - name: Test if zfs_exporter binary exists
      stat:
        path: /usr/local/bin/zfs_exporter
      register: zfs_exporter_binary
    
    - name: Install the zfs exporter
      block:
        - name: Download the zfs exporter
          delegate_to: localhost
          ansible.builtin.unarchive:
            src: https://github.com/pdf/zfs_exporter/releases/download/v{{ zfs_exporter_version }}/zfs_exporter-{{ zfs_exporter_version }}.linux-amd64.tar.gz
            dest: /tmp/
            remote_src: yes
    
        - name: Upload the zfs exporter to the server
          become: true
          copy:
            src: /tmp/zfs_exporter-{{ zfs_exporter_version }}.linux-amd64/zfs_exporter
            dest: /usr/local/bin
            mode: 0755
      when: not zfs_exporter_binary.stat.exists
    

Continuous Integration

Drone

  • New: Create the administrators.

    When you configure the Drone server you can create the initial administrative account by passing the below environment variable, which defines the account username (e.g. github handle) and admin flag set to true.

    DRONE_USER_CREATE=username:octocat,admin:true
    

    If you need to grant the primary administrative role to an existing user, you can provide an existing username. Drone will update the account and grant administrator role on server restart.

    You can create administrator accounts using the command line tools. Please see the command line tools documentation for installation instructions.

    Create a new administrator account:

    $ drone user add octocat --admin
    

    Or grant the administrator role to existing accounts:

    $ drone user update octocat --admin
    
  • New: Linter: untrusted repositories cannot mount host volumes.

    Thats because the repository is not trusted.

    You have to set the trust as an admin of drone through the GUI or through the CLI with

    drone repo update --trusted <your/repo>
    

    If you're not an admin the above command returns a success but you'll see that the trust has not changed if you run

    drone repo info <your/repo>
    

Storage

OpenZFS

  • New: See how much space do your snapshots consume.

    When a snapshot is created, its space is initially shared between the snapshot and the file system, and possibly with previous snapshots. As the file system changes, space that was previously shared becomes unique to the snapshot, and thus is counted in the snapshot’s used property.

    Additionally, deleting snapshots can increase the amount of space that is unique for use by other snapshots.

    Note: The value for a snapshot’s space referenced property is the same as that for the file system when the snapshot was created.

    You can display the amount of space that is consumed by snapshots and descendant file systems by using the zfs list -o space command.

    NAME                             AVAIL   USED  USEDSNAP  USEDDS  USEDREFRESERV  USEDCHILD
    rpool                            10.2G  5.16G         0   4.52M              0      5.15G
    rpool/ROOT                       10.2G  3.06G         0     31K              0      3.06G
    rpool/ROOT/solaris               10.2G  3.06G     55.0M   2.78G              0       224M
    rpool/ROOT/solaris@install           -  55.0M         -       -              -          -
    rpool/ROOT/solaris/var           10.2G   224M     2.51M    221M              0          0
    rpool/ROOT/solaris/var@install       -  2.51M         -       -              -          -
    

    From this output, you can see the amount of space that is:

    • AVAIL: The amount of space available to the dataset and all its children, assuming that there is no other activity in the pool.
    • USED: The amount of space consumed by this dataset and all its descendants. This is the value that is checked against this dataset's quota and reservation. The space used does not include this dataset's reservation, but does take into account the reservations of any descendants datasets.

      The used space of a snapshot is the space referenced exclusively by this snapshot. If this snapshot is destroyed, the amount of used space will be freed. Space that is shared by multiple snapshots isn't accounted for in this metric. * USEDSNAP: Space being consumed by snapshots of each data set * USEDDS: Space being used by the dataset itself * USEDREFRESERV: Space being used by a refreservation set on the dataset that would be freed if it was removed. * USEDCHILD: Space being used by the children of this dataset.

    Other space properties are:

    • LUSED: The amount of space that is "logically" consumed by this dataset and all its descendents. It ignores the effect of compression and copies properties, giving a quantity closer to the amount of data that aplication ssee. However it does include space consumed by metadata.
    • REFER: The amount of data that is accessible by this dataset, which may or may not be shared with other dataserts in the pool. When a snapshot or clone is created, it initially references the same amount of space as the filesystem or snapshot it was created from, since its contents are identical.

ZFS Prometheus exporter

  • New: Introduce the ZFS exporter.

    You can use a zfs exporter to create alerts on your ZFS pools, filesystems, snapshots and volumes.

    It's not easy to match the exporter metrics with the output of zfs list -o space. Here is a correlation table:

    • USED: zfs_dataset_used_bytes{type="filesystem"}
    • AVAIL: zfs_dataset_available_bytes{type="filesystem"}
    • LUSED: zfs_dataset_logical_used_bytes{type="filesystem"}
    • USEDDS: zfs_dataset_used_by_dataset_bytes="filesystem"}
    • USEDSNAP: Currently there is no published metric to get this data. You can either use zfs_dataset_used_bytes - zfs_dataset_used_by_dataset_bytes which will show wrong data if the dataset has children or try to do sum by (hostname,filesystem) (zfs_dataset_used_bytes{type='snapshot'}) which returns smaller sizes than expected.

    It also covers the installation as well as some nice alerts.

Monitoring

Blackbox Exporter

  • New: Check TCP with TLS.

    If you want to test for example if an LDAP is serving the correct certificate on the port 636 you can use:

    tcp_ssl_connect:
      prober: tcp
      timeout: 10s
      tls: true
    
    - name: Ldap
      url: my-ldap-server:636
      module: tcp_ssl_connect
    

Operating Systems

Linux

Linux Snippets

  • New: Reset failed systemd services.

    Use systemctl to remove the failed status. To reset all units with failed status:

    systemctl reset-failed
    

    or just your specific unit:

    bash systemctl reset-failed openvpn-server@intranert.service