Differential D25007 Diff 21 src/docs/user/field/performance.diviner

Changeset View

Standalone View

src/docs/user/field/performance.diviner

Show All 17 Lines	- DarkConsole helps you dig into a specific slow page and understand
service calls. This is a general, mid-level tool.		service calls. This is a general, mid-level tool.
- XHProf gives you detailed application performance profiles. This		- XHProf gives you detailed application performance profiles. This
is a fine-grained, low-level tool.		is a fine-grained, low-level tool.

Performance and the Upstream		Performance and the Upstream
============================		============================

Performance issues and hangs will often require upstream involvement to fully		Performance issues and hangs will often require upstream involvement to fully
resolve. The intent is for Phabricator to perform well in all reasonable cases,		resolve. The intent is for Phorge to perform well in all reasonable cases,
not require tuning for different workloads (as long as those workloads are		not require tuning for different workloads (as long as those workloads are
generally reasonable). Poor performance with a reasonable workload is likely a		generally reasonable). Poor performance with a reasonable workload is likely a
bug, not a configuration problem.		bug, not a configuration problem.

However, some pages are slow because Phabricator legitimately needs to do a lot		However, some pages are slow because Phorge legitimately needs to do a lot
of work to generate them. For example, if you write a 100MB wiki document,		of work to generate them. For example, if you write a 100MB wiki document,
Phabricator will need substantial time to process it, it will take a long time		Phorge will need substantial time to process it, it will take a long time
to download over the network, and your browser will probably not be able to		to download over the network, and your browser will probably not be able to
render it especially quickly.		render it especially quickly.

We may be able to improve performance in some cases, but Phabricator is not		We may be able to improve performance in some cases, but Phorge is not
magic and can not wish away real complexity. The best solution to these problems		magic and can not wish away real complexity. The best solution to these problems
is usually to find another way to solve your problem: for example, maybe the		is usually to find another way to solve your problem: for example, maybe the
100MB document can be split into several smaller documents.		100MB document can be split into several smaller documents.

Here are some examples of performance problems under reasonable workloads that		Here are some examples of performance problems under reasonable workloads that
the upstream can help resolve:		the upstream can help resolve:

- {icon check, color=green} Commenting on a file and mentioning that same		- {icon check, color=green} Commenting on a file and mentioning that same
▲ Show 20 Lines • Show All 134 Lines • Show Last 20 Lines