mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
5e078383a7
49809a03 Merge commit '20a631b4964fc0ab9137cce1e41774cbc17de044' 20a631b4 Squashed 'themes/gohugoioTheme/' changes from b8202f539..dafc91ff1 8b58f565 Re-generate CLI docs 4653a724 Add Netlify deployment badge 2d6246bc Remove some deprecated site variables e6777153 Improve Algolia Search Display Styling 1570999f Add missing "." in front of gitlab-ci.yaml example b922ae7d This adds documentation to the new configDir/Environment logic from .53 (#729) 7cff379f Correctly escape multi-word taxonomy terms in example 2dfeeda4 fix typo by removing stray paren 0870bd9a Fix typo in `paginate` description 91e8be85 Fixes https://github.com/gohugoio/hugo/issues/5609 c1db65ec Make the dummy URL more obvious b4589ff0 Fix a link b73dcb9a Consistently use "posts" as section name in examples 7a56abbc Format definitions a9c6fd9b Minor clarification over the last commit 5c86bdc8 Add alternative instructions for Quick Start for non-git users dafe7ee9 Add Visual Studio Code plug-ins 110ed19e Update HUGO_VERSION 2abd031a Update page.md b332f7b9 Update page.md f5a8c9d4 Update static-files.md 6d0c155c Add note about relative protocol URLs a13751ac Theme Warning: Remove note about unquoted URLs 4c8f7d68 Incorporate feedback 6f2b9cf0 Update Creating Themes Warning 40d88d98 Fix ToC example to use binary true/false 4a11f3f1 Fix typo 2dbfc0a4 Fix a typo in taxonomies d63790ef Do not mark UndocumentedFeature issues as stale d7aff095 Regenerate docs.json 71c0826f Update transform.Unmarshal.md git-subtree-dir: docs git-subtree-split: 49809a038b2691637bab7f3f2e385dde654a88b8
111 lines
4.1 KiB
Markdown
111 lines
4.1 KiB
Markdown
---
|
|
title: Build Performance
|
|
linktitle: Build Performance
|
|
description: An overview of features used for diagnosing and improving performance issues in site builds.
|
|
date: 2017-03-12
|
|
publishdate: 2017-03-12
|
|
lastmod: 2017-03-12
|
|
keywords: [performance, build]
|
|
categories: [troubleshooting]
|
|
menu:
|
|
docs:
|
|
parent: "troubleshooting"
|
|
weight: 3
|
|
slug:
|
|
aliases: []
|
|
toc: true
|
|
---
|
|
|
|
{{% note %}}
|
|
The example site used below is from https://github.com/gohugoio/hugo/tree/master/examples/blog
|
|
{{% /note %}}
|
|
|
|
## Template Metrics
|
|
|
|
Hugo is a very fast static site generator, but it is possible to write
|
|
inefficient templates. Hugo's *template metrics* feature is extremely helpful
|
|
in pinpointing which templates are executed most often and how long those
|
|
executions take **in terms of CPU time**.
|
|
|
|
| Metric Name | Description |
|
|
|---------------------|-------------|
|
|
| cumulative duration | The cumulative time spent executing a given template. |
|
|
| average duration | The average time spent executing a given template. |
|
|
| maximum duration | The maximum time a single execution took for a given template. |
|
|
| count | The number of times a template was executed. |
|
|
| template | The template name. |
|
|
|
|
```
|
|
▶ hugo --templateMetrics
|
|
Started building sites ...
|
|
|
|
Built site for language en:
|
|
0 draft content
|
|
0 future content
|
|
0 expired content
|
|
2 regular pages created
|
|
22 other pages created
|
|
0 non-page files copied
|
|
0 paginator pages created
|
|
4 tags created
|
|
3 categories created
|
|
total in 18 ms
|
|
|
|
Template Metrics:
|
|
|
|
cumulative average maximum
|
|
duration duration duration count template
|
|
---------- -------- -------- ----- --------
|
|
6.419663ms 583.605µs 994.374µs 11 _internal/_default/rss.xml
|
|
4.718511ms 1.572837ms 3.880742ms 3 indexes/category.html
|
|
4.642666ms 2.321333ms 3.282842ms 2 posts/single.html
|
|
4.364445ms 396.767µs 2.451372ms 11 partials/header.html
|
|
2.346069ms 586.517µs 903.343µs 4 indexes/tag.html
|
|
2.330919ms 211.901µs 2.281342ms 11 partials/header.includes.html
|
|
1.238976ms 103.248µs 446.084µs 12 posts/li.html
|
|
972.16µs 972.16µs 972.16µs 1 _internal/_default/sitemap.xml
|
|
953.597µs 953.597µs 953.597µs 1 index.html
|
|
822.263µs 822.263µs 822.263µs 1 indexes/post.html
|
|
567.498µs 51.59µs 112.205µs 11 partials/navbar.html
|
|
348.22µs 31.656µs 88.249µs 11 partials/meta.html
|
|
346.782µs 173.391µs 276.176µs 2 posts/summary.html
|
|
235.184µs 21.38µs 124.383µs 11 partials/footer.copyright.html
|
|
132.003µs 12µs 117.999µs 11 partials/menu.html
|
|
72.547µs 6.595µs 63.764µs 11 partials/footer.html
|
|
```
|
|
|
|
{{% note %}}
|
|
**A Note About Parallelism**
|
|
|
|
Hugo builds pages in parallel where multiple pages are generated
|
|
simultaneously. Because of this parallelism, the sum of "cumulative duration"
|
|
values is usually greater than the actual time it takes to build a site.
|
|
{{% /note %}}
|
|
|
|
|
|
## Cached Partials
|
|
|
|
Some `partial` templates such as sidebars or menus are executed many times
|
|
during a site build. Depending on the content within the `partial` template and
|
|
the desired output, the template may benefit from caching to reduce the number
|
|
of executions. The [`partialCached`][partialCached] template function provides
|
|
caching capabilities for `partial` templates.
|
|
|
|
{{% tip %}}
|
|
Note that you can create cached variants of each `partial` by passing additional
|
|
parameters to `partialCached` beyond the initial context. See the
|
|
`partialCached` documentation for more details.
|
|
{{% /tip %}}
|
|
|
|
|
|
## Step Analysis
|
|
|
|
Hugo provides a means of seeing metrics about each step in the site build
|
|
process. We call that *Step Analysis*. The *step analysis* output shows the
|
|
total time per step, the cumulative time after each step (in parentheses),
|
|
the memory usage per step, and the total memory allocations per step.
|
|
|
|
To enable *step analysis*, use the `--stepAnalysis` option when running Hugo.
|
|
|
|
|
|
[partialCached]:{{< ref "/functions/partialCached.md" >}}
|