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)