Sentry命令列工具之傳送事件
阿新 • • 發佈:2018-11-08
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。