{"__v":0,"_id":"5826158477286b39004dce84","category":{"project":"56ba46e2ce5d540d00e2d7a7","version":"56ba46e2ce5d540d00e2d7aa","_id":"582601f155b1060f00ec4173","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-11-11T17:37:53.355Z","from_sync":false,"order":1,"slug":"guides","title":"Guides"},"parentDoc":null,"project":"56ba46e2ce5d540d00e2d7a7","user":"5732062ad720220e008ea1d2","version":{"__v":12,"_id":"56ba46e2ce5d540d00e2d7aa","project":"56ba46e2ce5d540d00e2d7a7","createdAt":"2016-02-09T20:06:58.727Z","releaseDate":"2016-02-09T20:06:58.727Z","categories":["56ba46e3ce5d540d00e2d7ab","5771a6b145c7080e0072927f","5771a72eb0ea6b0e006a5221","5772e5b20a6d610e00dea073","577c3006b20f211700593629","57ae587bca3e310e00538155","57ae593a7c93fa0e001e6b50","57b1f8263ff6c519005cf074","582601f155b1060f00ec4173","582a62857a96051b0070b011","58ebfae58d5a860f00851fb9","590a75a1ec0d5e190095ab38"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-11-11T19:01:24.884Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"This guide covers how to use the source, app, and level filters located at the top of the page in the [LogDNA web app](https://app.logdna.com/).\n\nBefore we begin, keep in mind that filters are applied in conjunction with search and time queries. Any specified search queries and timeframes are respected in addition to the filters themselves.\n\n## Filters\n\n* **Source** contains a list of your logging sources. A source can be a host, computer, virtual machine, or Heroku app. Source metadata such as IP address or OS may be displayed with the .\n\n* **App** contains a list of logging buckets. An app can represent a log file, program or container. Typically, log lines within an app are inherently similar.\n\n* **Level** contains a list of parsed log levels, such as `INFO`, `DEBUG`, or `ERROR`. Log levels are automatically parsed from log lines using standard log level detection and common patterns.\n\n## Behavior\n\nTo use filters, click on the desired filter drop-down menu and tick the checkboxes of the entries you are interested in. Selecting more than one checkbox within a filter will include log lines that belong to any of the selected entries. Selecting checkboxes in more than on filter, such as selecting 1 app and 1 source, will return log lines that match both that app and that source.\n\nFor example, if I select two sources, `Oprah` and `Colbert`, and then select two apps, as `iMessage` and `Snapchat`, I will be returned all log lines matching the following conditions:\n(`Oprah` AND `iMessage`) OR (`Oprah` AND `Snapchat`) OR (`Colbert` AND `iMessage`) OR (`Colbert` AND `Snapchat`).\n\nSummary:\n* Selected entries within a filter are OR'd\n* Selected entries across filters are AND'd\n\n## Categories\n\nThe sources and apps filters include categories to help organize your sources and apps. For the sources filter, the categories are hosts, groups, and inactive hosts. For the apps filter, the categories are groups, apps, and files. You may see additional categories in the future.\n\n## Search\n\nFor the sources and apps filters, you can use the built-in search bar inside the filter menu. For example, if one of your sources was named 'Madonna', searching 'mdon' under Sources would return 'Madonna' as one of the results. Search results are also categorized by type.\n\n## Groups\n\nWithin the apps and sources filter you can create groups that represent a set of sources or apps. To create a group:\n1. Click on either the source or app filter, and then select the create new group option at the top of the drop-down menu.\n2. Name your group.\n3. Select the set of sources or apps you would like associate with this group.\n4. Click the green save button at the bottom of the modal.\n\nWhen you select the group in the source or app filter, it will return all log lines matching any of the entries within that group.\n\n## Dynamic Groups\n\nDynamic groups allow your hosts to automatically manage their dynamic group membership. To configure your hosts to automatically add themselves to dynamic groups ensure you are using the LogDNA agent to collect your logs. See the [host tags section of the LogDNA Agent article](https://docs.logdna.com/docs/logdna-agent#section-how-do-i-use-host-tags-) or the [host tags section of the rsyslog article](https://docs.logdna.com/docs/rsyslog#section-host-tags) for configuration details.\n\n## Metadata\n\nIf you mouse over an entry, depending on which category, additional details may be displayed. For example, under the Sources filter in the host section, mousing over an entry may show the IP address, operating system, and other details.","excerpt":"","slug":"filters","type":"basic","title":"Filters"}
This guide covers how to use the source, app, and level filters located at the top of the page in the [LogDNA web app](https://app.logdna.com/). Before we begin, keep in mind that filters are applied in conjunction with search and time queries. Any specified search queries and timeframes are respected in addition to the filters themselves. ## Filters * **Source** contains a list of your logging sources. A source can be a host, computer, virtual machine, or Heroku app. Source metadata such as IP address or OS may be displayed with the . * **App** contains a list of logging buckets. An app can represent a log file, program or container. Typically, log lines within an app are inherently similar. * **Level** contains a list of parsed log levels, such as `INFO`, `DEBUG`, or `ERROR`. Log levels are automatically parsed from log lines using standard log level detection and common patterns. ## Behavior To use filters, click on the desired filter drop-down menu and tick the checkboxes of the entries you are interested in. Selecting more than one checkbox within a filter will include log lines that belong to any of the selected entries. Selecting checkboxes in more than on filter, such as selecting 1 app and 1 source, will return log lines that match both that app and that source. For example, if I select two sources, `Oprah` and `Colbert`, and then select two apps, as `iMessage` and `Snapchat`, I will be returned all log lines matching the following conditions: (`Oprah` AND `iMessage`) OR (`Oprah` AND `Snapchat`) OR (`Colbert` AND `iMessage`) OR (`Colbert` AND `Snapchat`). Summary: * Selected entries within a filter are OR'd * Selected entries across filters are AND'd ## Categories The sources and apps filters include categories to help organize your sources and apps. For the sources filter, the categories are hosts, groups, and inactive hosts. For the apps filter, the categories are groups, apps, and files. You may see additional categories in the future. ## Search For the sources and apps filters, you can use the built-in search bar inside the filter menu. For example, if one of your sources was named 'Madonna', searching 'mdon' under Sources would return 'Madonna' as one of the results. Search results are also categorized by type. ## Groups Within the apps and sources filter you can create groups that represent a set of sources or apps. To create a group: 1. Click on either the source or app filter, and then select the create new group option at the top of the drop-down menu. 2. Name your group. 3. Select the set of sources or apps you would like associate with this group. 4. Click the green save button at the bottom of the modal. When you select the group in the source or app filter, it will return all log lines matching any of the entries within that group. ## Dynamic Groups Dynamic groups allow your hosts to automatically manage their dynamic group membership. To configure your hosts to automatically add themselves to dynamic groups ensure you are using the LogDNA agent to collect your logs. See the [host tags section of the LogDNA Agent article](https://docs.logdna.com/docs/logdna-agent#section-how-do-i-use-host-tags-) or the [host tags section of the rsyslog article](https://docs.logdna.com/docs/rsyslog#section-host-tags) for configuration details. ## Metadata If you mouse over an entry, depending on which category, additional details may be displayed. For example, under the Sources filter in the host section, mousing over an entry may show the IP address, operating system, and other details.