<commit_before>So you setup TFS Aggregator and it just sits there.... doing nothing...

Well, this is a check list of things to double check.


## Checklist

 -  You are using it on a TFS 2013 server (and you have the right version for the right server).
 -  Any aggregations between work items have a Parent-Child Link.
 -  You have updated a work item that needs aggregation. (The TFS Aggregation only works once a work item that has aggregation rules on it is updated. This may change in a future version.)
 -  You copied the DLLs and the Policies file to the plugins location on all TFS Application Tier Servers (Usually at: <Drive>`:\Program Files\Microsoft Team Foundation Server 12.0\Application Tier\Web Services\bin\Plugins`)
 -  You have valid names for source and destination fields in `TFSAggregator2.ServerPlugin.policies`.
 -  When you saved the file you saved it as utf-8 encoding (in Notepad++ it is called “utf-8 without BOM”) (This should not be an issue, but it does not hurt to check).


Also if you are having issues we recommend debugging your Policies file using `TFSAggregator2.ConsoleApp.exe` and trying that out.


## Enable Logging

You can also enable Logging if you are using a TFS 2013 or later version. There are two parts to enable logging.

The first is that you have to set a `level` attribute to the `logging` element in your `TFSAggregator2.ServerPlugin.policies` file.
Use a value like `Verbose` or `Diagnostic`.

```
<?xml version="1.0" encoding="utf-8"?>
<AggregatorConfiguration>
    <runtime>
        <logging level="Diagnostic"/>
    </runtime>
```

Then you need to download **DebugView** from Microsoft's SysInternals site.
DebugView is a Trace Listener and will capture the trace messages from TFSAggregator.
> **You have to run DebugView on _all_ TFS App Tier machines**.

We would recommend adding the following filter to DebugView so that you only see the TFSAggregator traces.
<commit_msg>Include adding the TFS Service Account to the Troubleshooting section.<commit_after>So you setup TFS Aggregator and it just sits there.... doing nothing...

Well, this is a check list of things to double check.


## Checklist

 -  You are using it on a TFS 2013 server (and you have the right version for the right server).
 -  Any aggregations between work items have a Parent-Child Link.
 -  You have updated a work item that needs aggregation. (The TFS Aggregation only works once a work item that has aggregation rules on it is updated. This may change in a future version.)
 -  You copied the DLLs and the Policies file to the plugins location on all TFS Application Tier Servers (Usually at: <Drive>`:\Program Files\Microsoft Team Foundation Server 12.0\Application Tier\Web Services\bin\Plugins`)
 -  You have valid names for source and destination fields in `TFSAggregator2.ServerPlugin.policies`.
 -  When you saved the file you saved it as utf-8 encoding (in Notepad++ it is called “utf-8 without BOM”) (This should not be an issue, but it does not hurt to check).
 -  You have given permission to the user running the plugin, i.e. the "TFS Service Account"


Also if you are having issues we recommend debugging your Policies file using `TFSAggregator2.ConsoleApp.exe` and trying that out.


## Enable Logging

You can also enable Logging if you are using a TFS 2013 or later version. There are two parts to enable logging.

The first is that you have to set a `level` attribute to the `logging` element in your `TFSAggregator2.ServerPlugin.policies` file.
Use a value like `Verbose` or `Diagnostic`.

```
<?xml version="1.0" encoding="utf-8"?>
<AggregatorConfiguration>
    <runtime>
        <logging level="Diagnostic"/>
    </runtime>
```

Then you need to download **DebugView** from Microsoft's SysInternals site.
DebugView is a Trace Listener and will capture the trace messages from TFSAggregator.
> **You have to run DebugView on _all_ TFS App Tier machines**.

We would recommend adding the following filter to DebugView so that you only see the TFSAggregator traces.

{'fraction_non_alphanumeric': 0.06631892697466468, 'fraction_numerical': 0.009438648782911079, 'mean_word_length': 4.021197007481296, 'pattern_counts': {'":': 0, '<': 15, '<?xml version=': 2, '>': 17, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 2}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3913497', 'n_tokens_mistral': 1117, 'n_tokens_neox': 1067, 'n_words': 590}