:plugin: meetup
:type: input
:default_codec: plain

///////////////////////////////////////////
START - GENERATED VARIABLES, DO NOT EDIT!
///////////////////////////////////////////
:version: %VERSION%
:release_date: %RELEASE_DATE%
:changelog_url: %CHANGELOG_URL%
:include_path: ../../../../logstash/docs/include
///////////////////////////////////////////
END - GENERATED VARIABLES, DO NOT EDIT!
///////////////////////////////////////////

[id="plugins-{type}s-{plugin}"]

=== Meetup input plugin

include::{include_path}/plugin_header.asciidoc[]

==== Description

Periodically query meetup.com regarding updates on events for the given Meetup key.

[id="plugins-{type}s-{plugin}-options"]
==== Meetup Input Configuration Options

This plugin supports the following configuration options plus the <<plugins-{type}s-{plugin}-common-options>> described later.

[cols="<,<,<",options="header",]
|=======================================================================
|Setting |Input type|Required
| <<plugins-{type}s-{plugin}-eventstatus>> |<<string,string>>|No
| <<plugins-{type}s-{plugin}-groupid>> |<<string,string>>|No
| <<plugins-{type}s-{plugin}-interval>> |<<number,number>>|Yes
| <<plugins-{type}s-{plugin}-meetupkey>> |<<string,string>>|Yes
| <<plugins-{type}s-{plugin}-urlname>> |<<string,string>>|No
| <<plugins-{type}s-{plugin}-venueid>> |<<string,string>>|No
| <<plugins-{type}s-{plugin}-text>> |<<string,string>>|No
|=======================================================================

Also see <<plugins-{type}s-{plugin}-common-options>> for a list of options supported by all
input plugins.

&nbsp;

[id="plugins-{type}s-{plugin}-eventstatus"]
===== `eventstatus` 

  * Value type is <<string,string>>.
  * Default value is `"upcoming,past"`.

Event Status can be one of `"upcoming"`, `"past"`, or `"upcoming,past"`. Default is `"upcoming,past"`.

[id="plugins-{type}s-{plugin}-groupid"]
===== `groupid` 

  * Value type is <<string,string>>.
  * There is no default value for this setting.

The Group ID, multiple may be specified seperated by commas. 
Must have one of `urlname`, `venueid`, `groupid`, `text`.

[id="plugins-{type}s-{plugin}-interval"]
===== `interval` 

  * This is a required setting.
  * Value type is <<number,number>>.
  * There is no default value for this setting.

Interval to run the command. Value is in minutes.

[id="plugins-{type}s-{plugin}-meetupkey"]
===== `meetupkey` 

  * This is a required setting.
  * Value type is <<string,string>>.
  * There is no default value for this setting.

Meetup Key, aka personal token.

[id="plugins-{type}s-{plugin}-urlname"]
===== `urlname` 

  * Value type is <<string,string>>.
  * There is no default value for this setting.

URLName - the URL name ie `ElasticSearch-Oklahoma-City`.
Must have one of urlname, venue_id, group_id, `text`.

[id="plugins-{type}s-{plugin}-venueid"]
===== `venueid` 

  * Value type is <<string,string>>.
  * There is no default value for this setting.

The venue ID
Must have one of `urlname`, `venue_id`, `group_id`, `text`.

[id="plugins-{type}s-{plugin}-text"]
===== `text` 

  * Value type is <<string,string>>.
  * There is no default value for this setting.

A text string to search meetup events by.
Must have one of `urlname`, `venue_id`, `group_id`, `text`.


[id="plugins-{type}s-{plugin}-common-options"]
include::{include_path}/{type}.asciidoc[]

:default_codec!: