systemd.timer 入門

systemd.timer を初めて設定する時、「うーん。」これであっているんだろうかって思った時に読んでください。

#Amazon Linux 2023

#systemd

#Amazon EC2

酒井剛

2025.04.08

Linux で定期実行処理を行う際に、cron に慣れ親しんでいる方も多いのではないかと思います。
Amazon Linux 2023 で、コマンドのスケジューリングをしようと、いざ cron を使おうと思ったら、あれ？ない！？ってなったことないでしょうか。

Amazon Linux 2023 ではデフォルトで systemd.timer が利用でき、これによって定期実行を行うことができます。
私自身、systemd.timer の設定について慣れていなかったため、調べたことを備忘録として残そうと思います。

ちなみに Amazon Linux 2023 の標準リポジトリでも cronie をインストールすれば、cron を利用することも可能ではあります。
実際にインストール可能かだけ、確認しておこうと思います。

$ sudo dnf info cronie
Amazon Linux 2023 Kernel Livepatch repository   107 kB/s |  15 kB     00:00
Available Packages
Name         : cronie
Version      : 1.5.7
Release      : 1.amzn2023.0.2
Architecture : x86_64
Size         : 115 k
Source       : cronie-1.5.7-1.amzn2023.0.2.src.rpm
Repository   : amazonlinux
Summary      : Cron daemon for executing programs at set times
URL          : https://github.com/cronie-crond/cronie
License      : MIT and BSD and ISC and GPLv2+
Description  : Cronie contains the standard UNIX daemon crond that runs
             : specified programs at scheduled times and related tools. It is a
             : fork of the original vixie-cron and has security and
             : configuration enhancements like the ability to use pam and
             : SELinux.

でもここはぐっと我慢して、systemd.timer を使っていきたいと思います。

systemd.timer とは

systemd.timer は .timer のファイル名拡張子と .service のファイル名拡張子の、２つの種類のファイルによって、スケジューリングおよび実行コマンドの定義を行います。
.timer には、主に定期実行のスケジューリングを記載し、.service には、主に実行するコマンドを記載します。
<ファイル名>.timer はデフォルトで同じ名前の <ファイル名>.service を参照します。

よって、何はともあれこの２つのファイルを用意する必要があるということです。

設定の流れ

設定の流れは以下の通りです。

/etc/systemd/system 配下に、.service の拡張子を持つファイルを作成する
/etc/systemd/system 配下に、.timer の拡張子を持つファイルを作成する
設定ファイルにエラーがないことを確認（systemd-analyze verify /etc/systemd/system/<作成したファイル>.*）
現在のセッションでのタイマー起動（sudo systemctl start <作成したファイル>.timer）
次回以降ブート時にタイマー起動（sudo systemctl enable <作成したファイル>.timer）
（設定変更時）ユニットファイルの設定変更
設定の反映（sudo systemctl daemon-reload）

systemd timer の仕様を理解するにあたって、チュートリアル形式で分かりやすいページがあったので、このチュートリアルを参考に確認していきます。

systemdタイマの操作

`.service` ファイルの作成

（前提としてスケジュール実行したいスクリプトファイルをあらかじめ用意しておきます）

$ vi /home/ec2-user/helloworld.sh
#!/bin/bash
echo "$(date) Hello world!" >> "/home/ec2-user/test"
sleep 5

/etc/systemd/system 配下に .service ファイルを作成します。

$ sudo tee /etc/systemd/system/helloworld.service << EOF > /dev/null
[Unit]
Description="Hello World script"

[Service]
ExecStart=/bin/bash /home/ec2-user/helloworld.sh
EOF

[Service]セクションでよく指定されるオプション

オプション	説明
User	コマンド実行ユーザー
ExecStart	実行コマンドを指定

User は、コマンド実行ユーザーを指定します。ここでは指定していないため、デフォルトのシステムルートで実行されます。後述で動作の違いを説明します。

`.timer` ファイルの作成

/etc/systemd/system 配下に .timer ファイルを作成します。

$ sudo tee /etc/systemd/system/helloworld.timer << EOF > /dev/null
[Unit]
Description="Run helloworld.service 5min after boot and every minute"

[Timer]
OnBootSec=5min
OnCalendar=*-*-* *:*:00
AccuracySec=100ms
Unit=helloworld.service

[Install]
WantedBy=multi-user.target
EOF

[Timer]セクションでよく指定されるオプション

オプション	説明
OnBootSecなど	単調タイマーのオプション※詳細は後述
OnCalendar	リアルタイマーのオプション※詳細は後述
AccuracySec	タイマーの精度
Unit	参照するサービスファイル

AccuracySecのデフォルト値は 1 minute (1分) の精度になっているため、1分以下のタイマー間隔は指定できません。1分未満の間隔でスケジューリングしたい場合は、AccuracySecを設定します。
Unitのデフォルト値は <ファイル名>.timer と同じ <ファイル名>.service を参照します。明示的に変更したい場合に設定します。
上記例の[Timer]セクションでは、いくつかのオプションを指定していますが、最小構成であればよく使う OnCalendar のみでも構いません。（スケジュールの指定方法は、後述の.timer ファイルのスケジュール指定方法を参照してください）

[Install]セクションでよく指定されるオプション

オプション	説明
WantedBy	systemdが動作するターゲット

WantedBy=multi-user.target、WantedBy=timers.targetのどちらでも良いみたいですが、この項目は必須で記述する必要があるようです。

設定の確認

２つの設定ファイルが用意できたので、それぞれのファイルのシンタックスが正しいかチェックします。
例えば、.timer 設定ファイルのオプション名が OnCalnder のようにタイポしていた場合は、チェックができます。
（以下はシンタックスチェックが失敗しているケースです）

$ systemd-analyze verify /etc/systemd/system/helloworld.*
/etc/systemd/system/helloworld.timer:8: Unknown key name 'OnCalnder' in section 'Timer', ignoring.

出力結果が返ってこなければシンタックスチェックはOKです。

タイマー起動

現在のセッションでタイマーを起動します。

$ sudo systemctl start helloworld.timer

ステータスを確認します。

$ systemctl status helloworld.timer
● helloworld.timer - "Run helloworld.service 5min after boot and every minute"
     Loaded: loaded (/etc/systemd/system/helloworld.timer; disabled; preset: disabled)
     Active: active (waiting) since Mon 2025-04-07 23:15:47 UTC; 6s ago
    Trigger: Mon 2025-04-07 23:16:00 UTC; 6s left
   Triggers: ● helloworld.service

Apr 07 23:15:47 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.timer - "Run helloworld.service 5min after boot and every minute".

ブート時にも自動起動を行うよう設定します。

$ sudo systemctl enable helloworld.timer
Created symlink /etc/systemd/system/multi-user.target.wants/helloworld.timer → /etc/systemd/system/helloworld.timer.

設定できているか確認します。

$ systemctl list-timers
NEXT                        LEFT          LAST                        PASSED   UNIT                             ACTIVATES
Mon 2025-04-07 23:17:53 UTC 8s left       Mon 2025-04-07 23:16:53 UTC 51s ago  refresh-policy-routes@enX0.timer refresh-policy-routes@enX0.service
Mon 2025-04-07 23:18:00 UTC 14s left      Mon 2025-04-07 23:17:00 UTC 45s ago  helloworld.timer                 helloworld.service
Mon 2025-04-07 23:20:00 UTC 2min 14s left Mon 2025-04-07 23:10:31 UTC 7min ago sysstat-collect.timer            sysstat-collect.service
Mon 2025-04-07 23:59:09 UTC 41min left    -                           -        update-motd.timer                update-motd.service
Tue 2025-04-08 00:00:00 UTC 42min left    -                           -        logrotate.timer                  logrotate.service
Tue 2025-04-08 00:07:00 UTC 49min left    -                           -        sysstat-summary.timer            sysstat-summary.service
Tue 2025-04-08 01:01:53 UTC 1h 44min left Mon 2025-04-07 01:01:53 UTC 22h ago  systemd-tmpfiles-clean.timer     systemd-tmpfiles-clean.service
Mon 2025-04-14 01:34:39 UTC 6 days left   -                           -        fstrim.timer                     fstrim.service

8 timers listed.
Pass --all to see loaded but inactive timers, too.

NEXT -> Mon 2025-04-07 23:18:00 UTC 次の実行時間
LEFT -> 14s left あとどれだけの時間で実行するか（2秒後）
LAST -> Mon 2025-04-07 23:17:00 UTC 前回実行した時間
PASSED -> 45s ago 前回実行から経過した時間（2秒経過）
UNIT -> helloworld.timer タイマーのファイル名
ACTIVATES -> helloworld.service サービスのファイル名

実行ログは journalctl を通じて確認することができます。
-u で特定のユニット名のみに絞って確認、-f でテールモードで監視することができます。

$ journalctl -u helloworld -f
Apr 07 23:15:47 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 23:15:52 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 23:16:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 23:16:05 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 23:17:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 23:17:05 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 23:18:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 23:18:05 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 23:19:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 23:19:05 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.

１分間隔で実行できていることが確認できます。

ユニットファイルの設定変更

タイマーの間隔や、サービスの実行オプションなど設定を変更したくなった場合は、.timer や .service の設定ファイルを直接編集します。

編集後には、設定ファイルのシンタックスチェックを再び行います。

$ systemd-analyze verify /etc/systemd/system/helloworld.*

## 出力がない場合は特にエラーなし

また、それぞれのファイルの中身を下記のコマンドで確認しておくと良いです。

$ systemctl cat helloworld
# Warning: helloworld.service changed on disk, the version systemd has loaded is outdated.
# This output shows the current version of the unit's original fragment and drop-in files.
# If fragments or drop-ins were added or removed, they are not properly reflected in this output.
# Run 'systemctl daemon-reload' to reload units.
# /etc/systemd/system/helloworld.service
[Unit]
Description="Hello World script"

[Service]
User=root
ExecStart=/bin/bash -c "date"

$ systemctl cat helloworld.timer
# Warning: helloworld.timer changed on disk, the version systemd has loaded is outdated.
# This output shows the current version of the unit's original fragment and drop-in files.
# If fragments or drop-ins were added or removed, they are not properly reflected in this output.
# Run 'systemctl daemon-reload' to reload units.
# /etc/systemd/system/helloworld.timer
[Unit]
Description="Run helloworld.service 5min after boot and every 24 hours relative to activation time"

[Timer]
AccuracySec=100ms
OnUnitActiveSec=5sec
Unit=helloworld.service
OnCalnder=aa

[Install]
WantedBy=multi-user.target

以下のコマンドを実行すると設定反映が行われ、タイマーが新しい設定内容に従って起動します。

$ sudo systemctl daemon-reload

その他、タイマーをストップする時

$ sudo systemctl stop helloworld

自動起動をオフにする時

$ sudo systemctl disable helloworld

こちらも覚えておきます。

詳細設定の補足

以下は、詳細な制御を行いたい時の設定の補足説明です。

`.service` ファイルの実行ユーザー権限

.service ファイルの User オプションによる動きを確認してみます。
まず最初に指定していない場合です。

$ systemctl cat helloworld.service
# /etc/systemd/system/helloworld.service
[Unit]
Description="Hello World script"

[Service]
ExecStart=/bin/bash /home/ec2-user/helloworld.sh

設定を反映します。

$ sudo systemctl daemon-reload

１分に一回スケジュールを実行、スクリプトは実行されてから５秒間待機するようになっているので、スケジューリングが開始したタイミングでプロセスの実行者が誰か確認してみます。

$ journalctl -u helloworld -f
Apr 07 23:25:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 23:25:05 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 23:26:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 23:26:05 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 23:27:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 23:27:05 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 23:28:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 23:28:05 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 23:29:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 23:29:05 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 23:30:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
^C

$ ps aux | grep helloworld.sh | egrep -v grep
root       80831  0.0  0.3 223008  3352 ?        Ss   23:29   0:00 /bin/bash /home/ec2-user/helloworld.sh

rootユーザーで実行されていることが確認できました。

次に、User=ec2-user を追記して、実行ユーザーを変更してみます。

$ systemctl cat helloworld.service
# Warning: helloworld.service changed on disk, the version systemd has loaded is outdated.
# This output shows the current version of the unit's original fragment and drop-in files.
# If fragments or drop-ins were added or removed, they are not properly reflected in this output.
# Run 'systemctl daemon-reload' to reload units.
# /etc/systemd/system/helloworld.service
[Unit]
Description="Hello World script"

[Service]
User=ec2-user
ExecStart=/bin/bash /home/ec2-user/helloworld.sh

設定を反映します。

$ sudo systemctl daemon-reload

同じように実行者を確認してみます。

$ journalctl -u helloworld -f
Apr 07 23:33:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 23:33:05 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 23:34:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 23:34:05 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 23:35:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 23:35:05 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 23:36:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 23:36:05 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 23:37:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 23:37:05 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 23:38:00 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
^C

$ ps aux | grep helloworld.sh | egrep -v grep
ec2-user   81310  0.0  0.3 222952  3192 ?        Ss   23:37   0:00 /bin/bash /home/ec2-user/helloworld.sh

ec2-user で実行できていることが確認できました。

`.timer` ファイルのスケジュール指定方法

Timer のスケジュールには、単調タイマー（Monotonic timers）とリアルタイムタイマーがあります。
リアルタイムタイマーは実行する時間を指定します。

オプション	意味
OnCalendar	実行する日時

OnCalendar=<DayOfWeek> <Year-Month-Day> <Hour:Minute:Second>

<DayOfWeek>、指定できる値は、Sun、Mon、Tue、Wed、Thu、Fri、Satです。曜日を無視する場合は省略します。
<Year-Month-Day>、月と日を2桁で指定し、年を4桁で指定します。該当するあらゆる日時と一致するように、各値をワイルドカードで置き換えることができます。
<Hour:Minute:Second>、各値を2桁で指定します。該当するあらゆる日時と一致するように、各値をワイルドカードで置き換えることができます。
（その他の詳細は以下のマニュアル参照）

systemd.time(7) - Linux manual page

設定は以下のように、月曜日から金曜日の10:00に実行、土曜日・日曜日の22:00に実行のように指定ができます。

$ sudo tee /etc/systemd/system/helloworld.timer << EOF > /dev/null
[Unit]
Description="Run helloworld.service"

[Timer]
OnCalendar=Mon..Fri *-*-* 10:00
OnCalendar=Sat,Sun *-*-* 22:00

[Install]
WantedBy=multi-user.target
EOF

その他、1分以下の間隔での指定も可能ですが、別途 AccuracySec=100ms のように、精度を細かく調整する必要があります。
（単調タイマーの定義の方法でも同じことです。）

## 精度を細かくする必要あり
AccuracySec=100ms

## 1分ごと
OnCalendar=*-*-* *:*:00

## 5秒毎
OnCalendar=*-*-* *:*:00/5

## 1秒ごと
OnCalendar=*-*-* *:*:*

1秒毎で試してみたところ速すぎて失敗してしまうようです。

$ journalctl -u helloworld -f
Apr 07 06:59:29 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 06:59:29 ip-172-31-33-181.ap-northeast-1.compute.internal bash[42557]: Mon Apr  7 06:59:29 UTC 2025
Apr 07 06:59:29 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 06:59:30 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 06:59:30 ip-172-31-33-181.ap-northeast-1.compute.internal bash[42558]: Mon Apr  7 06:59:30 UTC 2025
Apr 07 06:59:30 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 06:59:31 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 06:59:31 ip-172-31-33-181.ap-northeast-1.compute.internal bash[42560]: Mon Apr  7 06:59:31 UTC 2025
Apr 07 06:59:31 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 06:59:32 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 06:59:32 ip-172-31-33-181.ap-northeast-1.compute.internal bash[42561]: Mon Apr  7 06:59:32 UTC 2025
Apr 07 06:59:32 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 06:59:33 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Start request repeated too quickly.
Apr 07 06:59:33 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Failed with result 'start-limit-hit'.
Apr 07 06:59:33 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Failed to start helloworld.service - "Hello World script".
Apr 07 06:59:34 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Start request repeated too quickly.
Apr 07 06:59:34 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Failed with result 'start-limit-hit'.
Apr 07 06:59:34 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Failed to start helloworld.service - "Hello World script".
Apr 07 06:59:35 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Start request repeated too quickly.
Apr 07 06:59:35 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Failed with result 'start-limit-hit'.
Apr 07 06:59:35 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Failed to start helloworld.service - "Hello World script".
Apr 07 06:59:36 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Start request repeated too quickly.
Apr 07 06:59:36 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Failed with result 'start-limit-hit'.
Apr 07 06:59:36 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Failed to start helloworld.service - "Hello World script".
Apr 07 06:59:37 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Start request repeated too quickly.
Apr 07 06:59:37 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Failed with result 'start-limit-hit'.
Apr 07 06:59:37 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Failed to start helloworld.service - "Hello World script".
Apr 07 06:59:38 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Start request repeated too quickly.
Apr 07 06:59:38 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Failed with result 'start-limit-hit'.
Apr 07 06:59:38 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Failed to start helloworld.service - "Hello World script".
Apr 07 06:59:39 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 06:59:39 ip-172-31-33-181.ap-northeast-1.compute.internal bash[42562]: Mon Apr  7 06:59:39 UTC 2025
Apr 07 06:59:39 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.
Apr 07 06:59:40 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: Started helloworld.service - "Hello World script".
Apr 07 06:59:40 ip-172-31-33-181.ap-northeast-1.compute.internal bash[42563]: Mon Apr  7 06:59:40 UTC 2025
Apr 07 06:59:40 ip-172-31-33-181.ap-northeast-1.compute.internal systemd[1]: helloworld.service: Deactivated successfully.

単調タイマーは、何らかのイベントからの経過時間を定義し、その経過時間に達した時にトリガーを引くことができます。

何らかのイベント
は以下の中から定義することができ、これらの定義からの経過時間をトリガーの条件として指定します。

オプション	意味
OnActiveSec	タイマーサービスが最後にアクティブになった時間(.timer 起動時)
OnBootSec	OS起動時間
OnStartupSec	サービスマネージャー（Systemdのこと）が起動した時間
OnUnitActiveSec	タイマーが参照するサービスが最後に起動した時間(.timer でサービスが呼び出された時)
OnUnitInactiveSec	タイマーが参照するサービスが最後に停止した時間(.timer で呼び出されたサービスが停止した時)

使用できる単位は、usec、msec、seconds、minutes、hours、days、weeks、months、yearsです。
短縮系のmin、h、d、wなども使えます。（詳細は以下のマニュアル参照）

systemd.time(7) - Linux manual page

設定は以下のように、OS起動してから5分後に実行、その後24時間毎に実行というように指定できます。
OnUnitActiveSec は、繰り返し実行処理のための定義として使うことが多いですが、その場合は、OnActiveSec、OnBootSec、OnStartupSecなどを同時に記載しておく必要があります。
OnUnitActiveSec はサービスが起動した時間を起点にするので、最初の一回を起動する必要があるので注意が必要です。

$ sudo tee /etc/systemd/system/helloworld.timer << EOF > /dev/null
[Unit]
Description="Run helloworld.service"

[Timer]
OnBootSec=5min
OnUnitActiveSec=24h

[Install]
WantedBy=multi-user.target
EOF

スケジューリングのテスト

単調タイマーにしろ、リアルタイムタイマーにしろ、設定したいスケジューリング通りにコンフィグがかけているか心配になるときがあります。
そんな時は、設定しようとしている構文が実際どのようにして動作するかをあらかじめテストします。

OnCalendar=,Sun *-*-* 01,03:00:00 と書こうとしている時に、実際にいつのタイミングでトリガーされるかを確認します。

$ systemd-analyze calendar "Tue,Sun *-*-* 01,03:00:00" && date
Normalized form: Tue,Sun *-*-* 01,03:00:00
    Next elapse: Tue 2025-04-08 01:00:00 UTC
       From now: 59min left
Tue Apr  8 00:00:37 UTC 2025

現在、2025/4/8 00:00:37 Tue UTC で、2025/4/8 01:00:00 Tue UTC に実行されることが分かります。

５回分を確認することも可能です。
火曜日、日曜日の01:00:00と03:00:00に実行する定義となっているので、想定通りかと思います。

$ systemd-analyze calendar --iterations 5 "Tue,Sun *-*-* 01,03:00:00" && date
Normalized form: Tue,Sun *-*-* 01,03:00:00
    Next elapse: Tue 2025-04-08 01:00:00 UTC
       From now: 57min left
       Iter. #2: Tue 2025-04-08 03:00:00 UTC
       From now: 2h 57min left
       Iter. #3: Sun 2025-04-13 01:00:00 UTC
       From now: 5 days left
       Iter. #4: Sun 2025-04-13 03:00:00 UTC
       From now: 5 days left
       Iter. #5: Tue 2025-04-15 01:00:00 UTC
       From now: 1 week 0 days left
Tue Apr  8 00:02:59 UTC 2025

単調タイマーの場合は、systemd-analyze calendar の代わりに、systemd-analyze timespan を使います。

$ systemd-analyze timespan "15days 6h 32m"
Original: 15days 6h 32m
      μs: 1319520000000
   Human: 2w 1d 6h 32min

cron から置き換える時の読み替え

cron の設定から systemd.timer の設定に置き換える時のスケジューリングです。

Cron	systemd timer
@reboot	OnBootSec=1s
@yearly	OnCalendar=*-01-01 00:00:00
@annually	OnCalendar=*-01-01 00:00:00
@monthly	OnCalendar=--01 00:00:00
@weekly	OnCalendar=Sun --* 00:00:00
@daily	OnCalendar=--* 00:00:00
@hourly	OnCalendar=--* *:00:00

最後に

systemd.timer はユニットファイル（.serviceと.timer）を作成する必要があるので、最初は慣れが必要なのですが、ポイントを押さえれば問題なく設定することができました。
シンタックスの確認コマンド（systemd-analyze verify）、設定状況の確認（systemctl cat、systemctl list-timers、systemctl status）、ログの確認（journalctl -u <unitname> -f）など確認するためのコマンドが豊富なので、分かりやすいと感じました。
cron ではなく systemd.timer を利用しようと思った時に参考にしていただけると幸いです。