apm log-setting

apm log-setting(1)	      BIG-IP TMSH Manual	    apm log-setting(1)



NAME
       log-setting - Configures log configurations for various features in
       APM, such as URL Filter/Classification (URL Filter).

MODULE
       apm

SYNTAX
       Configure the log-setting component within the  module using the
       syntax shown in the following sections.

   CREATE/MODIFY
       Consider log-setting as a container for log configurations belonging to
       different features. At this time URL Filter is the only feature with a
       log setting.

	create log-setting [name]
	modify log-setting [name]
	  options:
	    description
	    url-filters [add | delete | modify | replace-all-with] {
	      [item name] {
		filter { log-allowed-url [true|false] log-blocked-url [true|false] }
		publisher [string]
	      }
	    }
	    access [add | delete | modify | replace-all-with] {
	      [item name] {
		log-level {
		  access-control [emerg|alert|crit|err|warn|notice|info|debug]
		  access-per-request [emerg|alert|crit|err|warn|notice|info|debug]
		  apm-acl [emerg|alert|crit|err|warn|notice|info|debug]
		  eca [emerg|alert|crit|err|warn|notice|info|debug]
		  paa [emerg|alert|crit|err|warn|notice|info|debug]
		  sso [emerg|alert|crit|err|warn|notice|info|debug]
		  swg [emerg|alert|crit|err|warn|notice|info|debug]
		}
		publisher [string]
	      }

   DISPLAY
	list log-setting
	list log-setting [ [ [name] | [glob] | [regex] ] ... ]
	  options:
	    all-properties
	    non-default-properties
	    one-line
	    partition

DESCRIPTION
       Configures a container for log configurations.

       NOTE: Each container can enclose log configurations for many different
       features. However, each feature can only have one log configuration in
       a container.

       NOTE: For the log configuration to take effect, the log-setting must be
       associated with an access profile (See man page for apm access
       profile).

       NOTE: A log-setting container cannot be deleted if it is associated
       with an access profile.

EXAMPLES
       create log-setting my-log-cfg

       Creates a container without any log configuration.

       create log-setting my-log-cfg url-filters add { my-urlf { filter { log-
       allowed-url true } publisher my-publisher } }

       Creates a container with a log configuration for the URL Filter
       feature. At this version, URL Filter is the only feature with a log
       configuration.

       modify log-setting my-log-cfg url-filters modify { my-urlf { publisher
       my-other-publisher } }

       Modify the publisher of a log configuration.

       modify log-setting my-log-cfg url-filters modify { my-urlf { filter {
       log-allowed-url false } } }

       Modify the setting of a log filter

       create log-setting my-log-cfg access add { my-access { publisher my-
       publisher } }

       Creates a container with a log configuration for APM logging.

       modify log-setting my-log-cfg access modify { my-access { log-level {
       access-control debug } } }

       Modify the log level for module access-control.

OPTIONS
       description
	    Specifies a unique description for the log-setting container.

       url-filters
	    This is the list to store log configurations for the URL Filter
	    feature.

       item name
	    Specifies the name of the log configuration to be added to the
	    list url-filters. Currently, the list supports only one item.

       filter
	    Specifies the value for different log filters. In particular, URL
	    Filter log configuration has two filters:
		log-allowed-url [true|false]
		log-blocked-url [true|false]

       publisher
	    Specifies the publisher of the log configuration. See sys log-
	    config publisher.

       access
	    This is the list to store log configurations for APM logging.

       log-level
	    This is the list of log level settings for different modules in
	    the APM family.

SEE ALSO
       apm profile access and sys log-config

COPYRIGHT
       No part of this program may be reproduced or transmitted in any form or
       by any means, electronic or mechanical, including photocopying,
       recording, or information storage and retrieval systems, for any
       purpose other than the purchaser's personal use, without the express
       written permission of F5 Networks, Inc.

       F5 Networks and BIG-IP (c) Copyright 2011, 2013-2014, 2016. All rights
       reserved.



BIG-IP				  2016-04-21		    apm log-setting(1)