概述

如果您使用 PyCharm 進(jìn)行開發(fā)，則需要配置一些內(nèi)容才能運(yùn)行和調(diào)試。

本文檔描述了一些對 sentry 開發(fā)有用的配置

配置

Python 解釋器：(確保它是 venv 解釋器)例如 ~/venv/sentry/bin/python

要?jiǎng)?chuàng)建配置(run/debug 配置)，只需轉(zhuǎn)到 Run | Edit Configurations...(也可在默認(rèn)工具欄中使用)。

Test runner

Sentry 使用 pytest 進(jìn)行單元測試。

創(chuàng)建 pytest 配置(在 Python tests 下)

設(shè)定目標(biāo)(Set Target): Custom

附加參數(shù)(Additional Arguments): tests/sentry

具有所需一切的 Dev server

用于在所有設(shè)置(web、worker、cron)的情況下運(yùn)行(非調(diào)試)：

• 創(chuàng)建另一個(gè) Python 配置
• 腳本路徑(Script path): /bin/sentry e.g. ~/venv/sentry/bin/sentry
• 參數(shù)(Parameters): devserver --workers
• Python 解釋器(Python interpreter): venv interpreter
• 工作目錄(Working dir): (sentry 安裝目錄中的 src 路徑) e.g. ~/dev/sentry/src

Note: 您將無法使用此配置調(diào)試 Web Worker(Web Worker 是通過調(diào)用 uwsgi 服務(wù)器啟動(dòng)的)。

使用 PyCharm 進(jìn)行調(diào)試

devserver 命令的存在主要是為了在單獨(dú)的進(jìn)程中生成守護(hù)進(jìn)程，這意味著在默認(rèn)模式下將 debugger 附加到它并不是很有用。

Web server

devserver 命令有一個(gè)特殊的標(biāo)志，它將導(dǎo)致 web server 在同一進(jìn)程的線程中啟動(dòng)(而不是作為 web 守護(hù)進(jìn)程)。這允許啟動(dòng) devserver 的相同 PyCharm "Debug" 動(dòng)作附加到 web server 并在其后端命中斷點(diǎn)。

克隆你的 devserver 運(yùn)行配置并將 --debug-server 添加到 "Parameters" 字段的末尾。通過選擇 "Debug" 而不是 "Run" 來啟動(dòng)它。

--debug-server 標(biāo)志可能會(huì)導(dǎo)致進(jìn)程無法正確響應(yīng) SIGINT 并且關(guān)閉得比原始配置更不優(yōu)雅。建議保留兩者，將第一個(gè)與 Run 命令一起使用，將第二個(gè)與 Debug 命令一起使用。

您可以將 --workers 標(biāo)志與 --debug-server 一起保留，但請注意，不可能將斷點(diǎn)附加到 workers ，也不能附加到由 devserver 產(chǎn)生的任何其他守護(hù)進(jìn)程。

獨(dú)立守護(hù)進(jìn)程

要將 debugger 附加到除 web 之外的單個(gè)守護(hù)程序，請為守護(hù)程序創(chuàng)建運(yùn)行配置。以下屬性應(yīng)與您的 devserver 配置相同。(您可以克隆它并僅更改 Parameters 字段。)

• 腳本路徑(Script path): /bin/sentry，例如： ~/venv/sentry/bin/sentry
• Python 解釋器(Python interpreter): venv interpreter
• 工作目錄(Working dir): (sentry 安裝目錄中的 src 路徑)例如 ~/dev/sentry/src

將新運(yùn)行配置的參數(shù)設(shè)置為啟動(dòng)守護(hù)程序的 run 命令，例如：

• run cron
• run worker -c 1

提示和故障排除

• 如果您想調(diào)試它，相同的一組修改將適用于 getentry 項(xiàng)目的運(yùn)行配置。
• PyCharm 的 Compound 運(yùn)行配置類型對于一次啟動(dòng)多個(gè)運(yùn)行配置很有用。如果您正在調(diào)試一個(gè)或多個(gè)與開發(fā)服務(wù)器協(xié)同的獨(dú)立守護(hù)進(jìn)程，那么設(shè)置一個(gè)可能會(huì)很方便。

• 如果您希望 Sentry 在調(diào)試環(huán)境中的行為不同于常規(guī)運(yùn)行中的行為，您可以添加任意環(huán)境變量，然后在您的 .sentry/sentry.conf.py 文件中檢查它們。

例如，下面的屏幕截圖顯示了調(diào)試時(shí)禁用 APM 采樣的設(shè)置(因?yàn)樵跀帱c(diǎn)處停止會(huì)污染時(shí)間測量)。請注意，PYCHARM_DEBUG 是一個(gè)任意名稱;它對 PyCharm 和 Sentry 沒有特殊意義。

• 如果您單獨(dú)運(yùn)行的守護(hù)進(jìn)程不工作，您可以通過調(diào)試 devserver --debug-server 并在 src/sentry/runner/commands/devserver.py 上插入斷點(diǎn)來進(jìn)行故障排除。這將讓您手動(dòng)檢查 devserver 命令正在運(yùn)行的命令。(在底部附近尋找 manager.add_process 調(diào)用。)嘗試調(diào)整運(yùn)行配置中的參數(shù)以匹配這些命令，如果它們還沒有的話。