Log Settings

Log settings button To setup or make changes to how your event log works, you need to change the log settings. The settings button is located on the right side of the toolbar. Click it to open the settings panel.

The settings you can change depend on your role as a user. Admins can modify all settings, while Non-admins can only modify the Event Options.

Event Options
Details
Sharing
Classes
Web Forms
Api Keys
Advanced

Event Options

Event options settings The Event Options settings allow each user to customize what Loggr does when an event of a particular Event Class is posted. The current options are to send an email, create an alert or hide altogether.

Trigger Alert On Event
You may have noticed the Alerts tab on the Loggr Workspace. If you check this box for a particular Event Class, Loggr will flag the event as an alert which will show up under the Alerts tag, show up as an Alert on the Dashboard and show up as an Alert on the Loggr mobile apps. Alerts can be managed separately from events, meaning you can delete alerts and they will not delete the actual event that initiated the alert.

Don't Show Event Class
Click the check box and the events with the corresponding Class will not appear in the Loggr Workspace or the Loggr mobile apps. This is helpful for certain users. You may want to hide Error events from non-developers for example.

Notify By Email
One of the goals of Loggr is to avoid clogging up inboxes with application events and alerts, but in some cases it's important to use your email. If you want an event matching a certain Event Class to be emailed to you, click this checkbox. The email will be sent to the email address you have listed under your account.

top

Details

Log detail settings The Details settings allow you to change the title and icon for your log.

top

Sharing

Log sharing settings The Sharing tab shows the current list of people sharing the log. You can share your event log with other members of Loggr or with people that are not currently members. If the person is not currently a member of Loggr, they will be asked to create a free user account first. To share with another person, you'll need to create an invitation.

Share your log
To share your log with another person, click the Invite Someone button at the bottom of the Sharing tab. This will open a popup window which asks for details about the new person. Enter the name and the email address of the person. The name is only for display purposes while the email address is used to send the invitation. There is also a checkbox for making the new person an Admin (see below).

When you're done, click the Invite button. Loggr will send an invitation to the person. The new person will show as Invitation pending until they have accepted the invitation.

Edit a shared person
Click on the Edit link under a person's name/email. You may only edit the Name and Admin fields. If you need to change the Email Address for a person, you'll need to delete them and re-invite them with the new email address.

Stop sharing
To stop sharing your log with another person, click the Stop sharing link under the person's name/email. Deleting a person will only stop sharing, but does not actually delete the person's account with Loggr. NOTE: You cannot delete yourself or the owner of the log.

Admins
A person can be marked as an Admin. Admins can modify all log settings and delete events. Non-admins can only modify their Event Options and cannot delete events. NOTE: You cannot change the Admin field for yourself and you cannot turn off the Admin field for the owner of the log.

top

Classes

Event class settings Event Classes provide a way to classify your types of events so you can filter them out later for analysis. The Event Classes also allow you to specify a color for each Class which makes scanning your new events much easier.

Applying Classes
The log admin defines the Classes for each log. Loggr then checks every event that gets posted to your log and attaches only ONE class to an event that matches the criteria of the Class. If there are no Classes defined, or the event does not match the criteria specified in any of the Classes, no Class will be assigned to the event.

Because only a single Class can be assigned to any one event, there is a possibility of ambiguity when an event matches more than one Class. For this scenario we provide a Weight for each Class. Classes with a higher Weight will be assigned before Classes with lower Weight.

Note

Classes are only assigned to an event when they are posted. So keep in mind that any events received prior to a Class being defined will not be assigned a class. Only new events will be affected by new Classes.


Class Keys
One thing to become familiar with is the Key you assign to a new Class. Once you create a Class and set its Key, you will not be able to change the Key. In order to change a Key you will need to create a new Class, but keep in mind that this will not affect the Classes previously assigned to your events. We recommend you keep the Keys simple as we've done in the pre-defined Classes.

Pre-Defined Classes
When you create a new log we create a few basic Classes for you: New Events, Error Events and Trace Events. We find these are a good starting point, but feel free to delete them and add your own.

top

Web Forms

Web form settings The Web Forms settings enables you to specify additional, custom views on your event details. Web forms can be any web page. You specify a title, URL and optionally an Event Class.

Web Form URLs
The URL can be any web page. We will do a replacement of the macro {id} with the id of the event being viewed. For example, a URL like:

http://mycompany.com/custom/eventView.html?eid={id}

will be replaced and called with:

http://mycompany.com/custom/eventView.html?eid=e7499430e693469aba45e74d55a11cdb

Your Web Form can then use the Loggr Web API to display additional information based on that event id, like grab the username from the event and show details about the user from the internal CRM.

top

Api Keys

Api key settings Use the API Keys settings to manage your API Keys. You may want to give out a different Key for each agent that is posting events. This way you can better manage the access to your event log.

When you create an API Key, you'll want to choose the appropriate level of access. For example, if the key will just be used for posting events to your event log, choose Write Only. This will prevent anyone who has your key from reading your events or any other settings in your log.

top

Advanced

Advanced settings Advanced Settings are only available to log admins.

Error Throttling
With error events, it is common to have a flurry of repeated events with the same description. In some cases it may be helpful to log all of them, but most times you don't want them eating through your daily event limit.

By enabling Error Throttling, we'll track duplicates of events tagged with "error" for a sliding 15-second window. Duplicate events won't be logged. We'll just record the number of duplicates on the original event (as shown below).

Event showing Dupes property

Clear Log
PLEASE BE CAREFUL! This button will delete all events in your log. There is no way to recover them once you clear them.

top