Information on common Pitfalls and Anti-Patterns in Umbraco
This section highlights common pitfalls that developers often encounter. Some of the anti-patterns discussed here can lead to memory leaks, instability, or poor performance on your site. Be sure to read this section—it could save your site.
Generally speaking, if you are writing software these days you should be using Dependency Injection (DI) principles. If you do this, you probably are not using Singletons or Statics, and for the most part you should not be.
Since Umbraco comes with dependency injection out of the box, there really is not any reason to use singletons or statics. It makes your code difficult to test and hard to manage. Furthermore, the APIs become leaky and you will end up with more problems than when you started.
Dependency injection is available everywhere, and you can register your own services as well. Additionally, some resources are available through properties on certain base classes. For example, all Razor views that Umbraco creates expose an UmbracoHelper
property you can access through @Umbraco
. The other base classes that expose some things you might need like UmbracoContext
are things like SurfaceController
. Even here the services are initially gotten through DI, and you can inject further Umbraco and custom services that you might need.
For more information about consuming and registering your own dependencies have a look at the Dependency Injection documentation.
UmbracoHelper
The example below uses UmbracoApiController which is obsolete in Umbraco 14 and will be removed in Umbraco 15.
This practice can cause memory leaks along with inconsistent data results when using this _umbracoHelper
instance.
It is important to understand the difference between an object that has a Request-based scope and an object that has a Singleton/Application-based.
Application scope: If an object has a singleton/application scope, that means that this single object instance will exist for the lifetime of the application. The single instance will be shared by every thread that accesses it. Static variables will always be application lifespan.
Request scope: The web world is made up of requests and each request has its own thread. When an object is in the scope of a Request it only survives as long as the web request survives. At the end of the web request, it may either be disposed of or cleared from memory by the garbage collector. Request scoped object instances are not accessed by every other thread in the application unless you do something like the above.
An example of a request-scoped instance is the HttpContext
. This object exists for a single request and it cannot be shared between other threads. Especially not other request threads. This is because it is where the security information for a given user is stored. The UmbracoContext
is also a request-scoped object. In fact, it relies directly on an instance of HttpContext
. The UmbracoHelper
is request-scoped as well.
In the example above, the UmbracoHelper
which has a request-scoped lifetime, will be statically assigned to a variable. It means that this particular request-scoped object is now bound to an Application-scope lifetime and will never go away. This could mean that under certain circumstances an entire Umbraco cache copy is stuck in memory. It could also mean that the Security
property of the context will be accessed by multiple threads but this now contains the security information for a user for another request.
Additionally there is never really any reason to use static references. Instead, you should always inject your required resources, and let the DI container handle the lifetimes of the objects.
When using queries like this, you need to understand the implications. Here is a particularly bad scenario:
You have 10,000 content items in your tree and your tree structure is something like this:
You create a menu on your Home page like:
The query above renders out: Root, Home, Blog, Office Locations, About Us, Contact Us
This is going to iterate over every single node in Umbraco, all 10,000 of them. This will have a negative effect on the sites general performance.
Instead of using the snippet above, something similar to the sample below can be used:
In many cases, you might know that there is only ever going to be a small number of Descendants. If so using Descendants or DescendantsOrSelf will not have a negative affect on the sites performance. It is important to always be aware of the implications of what you are writing.
Querying and traversing content is not free. Anytime you make a query or resolve a property value there is overhead involved. Think about every query you make as an SQL call: Too many requests can have a negative effect on the sites performance.
Here is a common pitfall in relation to this.
Following the example above, the menu is going to be rendered using the current page's root node:
The @Model.Root()
syntax is shorthand for doing this: Model.AncestorOrSelf(1)
. This means that it is going to traverse up the tree until it reaches an ancestor node with a level of one. As mentioned above, traversing costs resources and in this example, there are 3x traversals being done for the same value.
Consider writing something similar to the example below:
The Services layer of Umbraco is for manipulating the business logic of Umbraco directly to/from the database. None of these methods should be used within your views and can have a negative impact on the performance and stability of your application.
Your views should rely only on the read-only data services such as UmbracoHelper
, ITagQuery
and IMemberManager
and the properties and methods they expose. This ensures that the data being queried comes from the cache and that you are not inadvertently making database changes.
For example, when retrieving a content item in your views:
If you are using services in your views, you should figure out why this is being done and, in most cases, remove this logic.
This is one of the anti-patterns that could have the highest negative impact on your sites performance.
Umbraco content should not be used for volatile data. The Umbraco APIs and the way Umbraco data is persisted was not designed for this. When you need to store, write or track data that changes a lot use a custom database table or another service. Do not use Umbraco content nodes for this.
Some examples of what not to do, and what to do instead:
Umbraco allows you to run some initialization code during startup by using UmbracoApplicationStartingNotification
. Depending on what code is run, it can have an impact on the application startup. This is especially true for Package developer as your code could end up impacting many websites.
In many cases, initialization code can be done lazily instead of eagerly. Instead of initialization everything you need as soon as the application starts you could execute your initialization code only when it is required. This can be achieved in different ways:
Using Lazy<T>
and put the initialization logic in its callback.
Using LazyInitializer
.
Putting logic in a property getter with a lock and setting a flag when it is processed.
Putting logic in a method with a lock and setting a flag when it is processed
The list above is not a complete list of options, as there are many different ways of achieving this.
It is important to ensure that the initialization logic executes only once for the lifetime of the application even when your app domain is restarted. If your initialization logic creates a database table that should only be executed one time, set a persistence flag. A persistence flag will indicate to your own logic that the initialization code has already been executed and does not need to be done again.
Rebuilding examine indexes can have a negative effect of the sites performance and is not a recommended practice. It is recommeded to ensure you are running the latest Umbraco and Examine versions if you are having trouble with out-of-sync index data.
The primary reasons your data will become out of sync are:
Old version of Umbraco.
Rebuilding indexes and restarting your app domain at the same time.
It is not recommended to rebuild your indexes unless you absolutely need to. If you need to do this often then it is advised to determine why and to try to resolve the underlying problem.
There is a couple of well known Examine events: TransformingIndexValues
and DocumentWriting
. Both of these events allow the developer to modify the data that is going into the Lucene index. Many times we see developers performing service lookups in these methods. For example, using IContentService.GetById(e.NodeId)
inside of these events could cause an N + 1
problem. This is because these events are executed for every single document being indexed. If you are rebuilding an index, this will mean that this logic will fire for every single document and media item going into each index. That could mean a large number of lookups and impact the site performance negatively.
Similarly, when executing logic in these events that perform poorly, then anytime you save or publish content or media it will slow that process down. And if you rebuild an index then any slow code running in these events will cause the indexing to go even slower.
The API method is called RenderTemplateAsync
allows you to be able to render a particular content item's template and get a IHtmlEncodedString
in response. This could be useful if you want to send an email based on a content item and its template. However, you must be careful not to use this for purposes it is not meant to be used for.
Do not use this method for rendering content as this could cause severe performance problems if abused. For normal content rendering of module type data from another content item, you should use Partial Views instead.
Constructors should generally not perform any logic. They should set parameter values, perform null checks and perhaps validate data.
There are a few reasons why this can become a performance problem:
The consumer of an API does not expect that by creating an object they should be worried about performance.
Creating an object can inadvertently happen many times, especially when using LINQ.
Here is an example of how this can go wrong.
Your tree structure is something like this:
You have a custom model that looks like this:
You run the following code to show the favorites:
To show the top 10 voted recipes's this will end up doing the following:
It will iterate over all 5000 Recipes.
It will create and allocate 5000 instances of RecipeModel
.
For each RecipeModel
created, it will traverse upwards, iterate all 5000 recipes then resolve property data for 2 properties.
This means that there is now an additional 5,000 new objects created and allocated in memory. The number of traversals/visits to each of these objects is now 5000 x 5000 = 25,000,000
.
The other problem is that the logic used to lookup related recipes is inefficient. Instead, each recipe should have a picker to choose its related recipe's and then each of those can be looked up by their ID.
The above example could be rewritten like this:
The code will still iterate over all Recipes meaning that the number of traversals/visits to each of these objects will be 5000.
There really is not much reason to create a RecipeModel
. Instead it could be written like:
Based on the above 2 points, you can see that iterating content with the traversal APIs ends up being expensive in terms of performance.
How to solve performance issues, will always depend on the specific scenario. One thing to consider is to cache the IDs of the content you need in your critical code. Then you could retrieve it from the cache by ID.
When you need to render the same four pieces of content for your navigation, then cache, or hardcode, the IDs of those content items. Then you can retrieve them with the ID using Umbraco.Content
. This will always be faster than trying to traverse your content tree and finding the content programmatically. It will do a direct lookup in the cache, meaning that your code does not have to do many traversals to get your content.
When memory is used, for instance creating 5,000 recipe models with a Select
statement, Garbage Collection needs to occur. This turnover can cause performance problems. The more objects created, the more items allocated in memory, the harder the job is for the Garbage Collector == more performance problems.
Even worse is when you allocate a lot of or large items in memory. They will remain in memory for a long time ending up in "Generation 3" which the GC tries to ignore for as long as possible. It does so because it knows it is going to take a lot of resources to clean up.
Extending models should be used to add stateless, local features to models. It should not be used to transform content models into view models or manage trees of content. You can read more about this in the Understanding and Extending Models Builder documentation
What not to do | Alternative |
---|---|
Hit counters to track the number of times your page has been viewed.
Use something like Google Analytics or a custom database table instead.
Creating new nodes for form submissions.
This should be stored in a custom database table.
Importing lots of data into Umbraco content nodes.
Import the data into custom database tables instead.