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)