Creating your own cartridge

To create your own cartridge, you need to install the Cartridge Builder. If you haven’t done yet, go the blog “Installing the Cartridge Builder tool”. If you have done it already, you can start to create your own cartridge to export custom dashboards, rules, report, … from your test server to apply it on your production server.

The example below shows how to export specific rules.

So first open the “Development Tools” dashboard and click on “Cartridge Builder”

Next is to create the cartridge name. It’s mandatory to add the author. That can be helpful months later if modification on the cartridge are needed. Same like the short description. So do not forget to write a good desccription.

Click on the name of the new cartridge to go to the next step – adding elements!

I want to export rules which I have created in my test server and those rules are using specific registry variables, so I have to export those too.

Starting with the rules, click on “add Rules” and the long list of all rules appear. Use the filter option to find the needed ones. Select them and click on “add to Cartridge”.

Next my registry variables which the rules are using. Click on “add Registry Values” and again you will get a list of all registry variables. Use the filter again to find the needed ones and as above, select them and click on “add to Cartridge”.

On the right hand side under “Cartridge Definition” you will find the elements you have added to your cartridge. Here you can remove elements if you added them by accident by clicking on the red minus icon.

Final step will be now to create the cartridge file by clicking on “Generate CAR File”. As you created the name already, you only need to set the version number of your cartridge and click on “Create”. You will get a short summary view, which shows you, the details of the cartridge. 

 

Beware that you can overwrite versions. If you change the cartridge, make sure you will always change the version number when creating a new cartridge file. So you can keep you cartridge history and download older versions when you have to go back to them.

Now download the cartridge and start deploying it on your production Foglight server.

 

 

Wasn’t that easy?

You can also export reports or dashboard which are bundled in your own WCF module or derived metrics, thresholds, your custom agent, schedules, …

Anonymous