Act Log

Act 管理

Act Log

デバイス上でActがカメラ画像などを解析して得た結果は Actcast へ送信されます。このとき送信されたデータをAct Logと呼びます。

Act Logは Cast のトリガーやアクションに利用することが出来ます。

また、Act Logは Actcast API 経由で取得することも可能です。詳細は Actcast API 経由での Act Log 取得を参照してください。

確認方法

Device Details画面でカメラボタンの右のアイコンからShow Act Logを選択すると、 Act から送信されたログを閲覧することができます。

act log

到達保証

ネットワーク環境の不調などでデバイスと Actcast との通信が正常に確立していない場合、Act Logは送信エラーとなり破棄されることがあります。またAct Logの送信前にデバイスの再起動が行われた場合にもデータが失われることがあります。

これらの場合にはAct Logは Actcast に到達せず、 Show Act Log画面で確認することや、Actcast API での取得、 Cast に利用することも出来ません。

保存期間

Act Logは 2 週間保存され、WebUI での閲覧や Actcast API からの取得が行えます。2 週間を過ぎたデータは自動的に削除されます。

Actcast API 経由での Act Log 取得

デバイスから送信されたAct Logは Actcast API 経由で取得することが可能です。

Actcast API の利用方法などはActcast APIをご確認ください。

Act Log 取得 API

Actcast API のデバイス上の Act Log 取得を利用することで、デバイスから送信されたAct Logを取得することができます。

以下が Actcast API を利用してAct Logを取得する例です。<your_api_token>、<group_id>、 <device_id> はそれぞれご自身の API トークン、グループ ID、デバイス ID に置き換えてください。

$ curl -H "Authorization: token <your_api_token>" \
    -X GET "https://api.actcast.io/v0/groups/<group_id>/devices/<device_id>/act_logs" | jq .
{
  "items": [
    {
      "device_id": "abcdef0-1234-5678-9abc-def012345678",
      "act_id": 123,
      "data": {
        ... // Act Log
      },
      "timestamp": "2024-08-14T01:51:55.426Z" // Act Logの送信日時(UTC)
    },
    {
      "device_id": "abcdef0-1234-5678-9abc-def012345678",
      "act_id": 123,
      "data": {
        ...
      },
      "timestamp": "2024-08-14T01:51:56.321Z"
    }
    ...
  ]
}

他にも期間指定やページネーションなどのオプションが利用可能です。詳細はAPI リファレンスをご確認ください。

最終更新日 2025/03/24