From b2fd4f9b254610283d3fa6944ea73941c2045769 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Fri, 16 Oct 2009 15:50:33 -0400 Subject: [PATCH] explain how to profile --- doc/tips/optimising_ikiwiki.mdwn | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/tips/optimising_ikiwiki.mdwn b/doc/tips/optimising_ikiwiki.mdwn index 6d0997603..085ef0306 100644 --- a/doc/tips/optimising_ikiwiki.mdwn +++ b/doc/tips/optimising_ikiwiki.mdwn @@ -140,6 +140,21 @@ That is accomplished as follows: Be aware that the [[plugins/search]] plugin has to update the search index whenever any page is changed. This can slow things down somewhat. +## profiling + +If you have a repeatable change that ikiwiki takes a long time to build, +and none of the above help, the next thing to consider is profiling +ikiwiki. + +The best way to do it is: + +* Install [[cpan Devel::NYTProf]] +* `PERL5OPT=-d:NYTProf` +* `export PER5OPT` +* Now run ikiwiki as usual, and it will generate a `nytprof.out` file. +* Run `nytprofhtml` to generate html files. +* Those can be examined to see what parts of ikiwiki are being slow. + ## scaling to large numbers of pages Finally, let's think about how huge number of pages can affect ikiwiki. -- 2.32.0.93.g670b81a890