1. 程式人生 > >Sentry命令列工具之傳送事件

Sentry命令列工具之傳送事件

sentry-cli工具也可用於傳送事件。如果要使用它,則需要匯出SENTRY_DSN環境變數並將其指向您的專案的DSN:

$ export SENTRY_DSN=https://<key>:<secret>@sentry.io/<project>

完成後,您可以開始使用sentry-cli send-event命令。

一、基本事件

對於基本訊息事件,您只需提供--message或-m引數來發送訊息:

$ sentry-cli send-event -m "Hello from Sentry"

這將向哨兵傳送一條訊息並將其記錄為事件。除此之外,它還會發送有關您正在執行sentry-cli的計算機的基本資訊。您可以多次提供-m以傳送多行:

$ sentry-cli send-event -m "Hello from Sentry" -m "This is more text"

二、帶引數的事件

此外,您可以在訊息中使用%s作為佔位符,並使用-a引數填充它。這有助於稽核它們,因為所有訊息都會自動分組在一起:

$ sentry-cli send-event -m "Hello %s!" -a "Joe"
$ sentry-cli send-event -m "Hello %s!" -a "Peter"

三、傳送麵包屑

您還可以將日誌檔案傳遞給send-event命令,該命令將作為breadcrumbs進行解析和傳送。最後100個專案將被髮送:

$ sentry-cli send-event -m “task failed” –logfile error.log

日誌檔案可以採用各種格式。如果你想自己建立一個,你可以沿著這些方向做一些事情:

$ echo "$(date +%c) This is a log record" >> output.log
$ echo "$(date +%c) This is another record" >> output.log
$ sentry-cli send-event -m "Demo Event" --logfile output.log
$ rm output.log

四、額外資料

可以使用-e引數將額外資料附加為KEY:VALUE。例如,您可以傳送一些鍵值對,如下所示:

$ sentry-cli send-event -m "a failure" -e task:create-user -e object:42

同樣,標籤可以使用相同的格式與-t一起傳送:

$ sentry-cli send-event -m "a failure" -t task:create-user

五、指定版本

可以使用--release引數傳送版本。如果您在git儲存庫中使用sentry-cli,則會自動獲取預設版本。

六、Bash鉤子

對於bash指令碼,您還可以使用sentry-cli bash掛鉤啟用自動錯誤傳送。這將啟用set -e並將為未處理的錯誤傳送sentry事件。

對此的限制是:

  • sentry-cli實際上只有在啟用set -e時才會起作用(預設情況下它會為你啟用)。
  • sentry-cli註冊一個EXIT和ERR陷阱。

用法: 

#!/bin/bash
export SENTRY_DSN=https://<key>:<secret>@sentry.io/<project>
eval "$(sentry-cli bash-hook)"

 或者,您可以使用.sentryclirc檔案等其他機制來配置dsn。