http://git-wip-us.apache.org/repos/asf/metron/blob/3d84ea42/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/KafkaEmitter.java ---------------------------------------------------------------------- diff --git a/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/KafkaEmitter.java b/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/KafkaEmitter.java deleted file mode 100644 index 87920da..0000000 --- a/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/KafkaEmitter.java +++ /dev/null @@ -1,164 +0,0 @@ -/* - * Licensed to the Apache Software Foundation (ASF) under one - * or more contributor license agreements. See the NOTICE file - * distributed with this work for additional information - * regarding copyright ownership. The ASF licenses this file - * to you under the Apache License, Version 2.0 (the - * "License"); you may not use this file except in compliance - * with the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - * - */ - -package org.apache.metron.profiler.bolt; - -import org.apache.commons.collections4.MapUtils; -import org.apache.commons.lang3.ClassUtils; -import org.apache.metron.profiler.ProfileMeasurement; -import org.apache.storm.task.OutputCollector; -import org.apache.storm.topology.OutputFieldsDeclarer; -import org.apache.storm.tuple.Fields; -import org.apache.storm.tuple.Values; -import org.json.simple.JSONObject; -import org.slf4j.Logger; -import org.slf4j.LoggerFactory; - -import java.io.Serializable; -import java.lang.invoke.MethodHandles; -import java.util.Map; - -/** - * Responsible for emitting a {@link ProfileMeasurement} to an output stream that will - * persist data in HBase. - */ -public class KafkaEmitter implements ProfileMeasurementEmitter, Serializable { - - protected static final Logger LOG = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass()); - - /** - * The stream identifier used for this destination; - */ - private String streamId = "kafka"; - - /** - * The 'source.type' of messages originating from the Profiler. - */ - private String sourceType = "profiler"; - - @Override - public void declareOutputFields(OutputFieldsDeclarer declarer) { - // the kafka writer expects a field named 'message' - declarer.declareStream(getStreamId(), new Fields("message")); - } - - @Override - public void emit(ProfileMeasurement measurement, OutputCollector collector) { - - // only need to emit, if there are triage values - Map<String, Object> triageValues = measurement.getTriageValues(); - if(MapUtils.isNotEmpty(triageValues)) { - - JSONObject message = createMessage(measurement); - appendTriageValues(measurement, message); - collector.emit(getStreamId(), new Values(message)); - - LOG.debug("Emitted measurement; stream={}, profile={}, entity={}, period={}, start={}, end={}", - getStreamId(), - measurement.getProfileName(), - measurement.getEntity(), - measurement.getPeriod().getPeriod(), - measurement.getPeriod().getStartTimeMillis(), - measurement.getPeriod().getEndTimeMillis()); - - } else { - - LOG.debug("No triage values, nothing to emit; stream={}, profile={}, entity={}, period={}, start={}, end={}", - getStreamId(), - measurement.getProfileName(), - measurement.getEntity(), - measurement.getPeriod().getPeriod(), - measurement.getPeriod().getStartTimeMillis(), - measurement.getPeriod().getEndTimeMillis()); - } - } - - /** - * Appends triage values obtained from a {@code ProfileMeasurement} to the - * outgoing message. - * - * @param measurement The measurement that may contain triage values. - * @param message The message that the triage values are appended to. - */ - private void appendTriageValues(ProfileMeasurement measurement, JSONObject message) { - - // for each triage value... - Map<String, Object> triageValues = MapUtils.emptyIfNull(measurement.getTriageValues()); - triageValues.forEach((key, value) -> { - - // append the triage value to the message - if(isValidType(value)) { - message.put(key, value); - - } else { - LOG.error(String.format( - "triage expression must result in primitive type, skipping; type=%s, profile=%s, entity=%s, expr=%s", - ClassUtils.getShortClassName(value, "null"), - measurement.getDefinition().getProfile(), - measurement.getEntity(), - key)); - } - }); - } - - /** - * Creates a message that will be emitted to Kafka. - * - * @param measurement The profile measurement used as a basis for the message. - * @return A message that can be emitted to Kafka. - */ - private JSONObject createMessage(ProfileMeasurement measurement) { - - JSONObject message = new JSONObject(); - message.put("profile", measurement.getDefinition().getProfile()); - message.put("entity", measurement.getEntity()); - message.put("period", measurement.getPeriod().getPeriod()); - message.put("period.start", measurement.getPeriod().getStartTimeMillis()); - message.put("period.end", measurement.getPeriod().getEndTimeMillis()); - message.put("timestamp", System.currentTimeMillis()); - message.put("source.type", sourceType); - message.put("is_alert", "true"); - return message; - } - - /** - * The result of a profile's triage expressions must be a string or primitive type. - * - * This ensures that the value can be easily serialized and appended to a message destined for Kafka. - * - * @param value The value of a triage expression. - * @return True, if the type of the value is valid. - */ - private boolean isValidType(Object value) { - return value != null && (value instanceof String || ClassUtils.isPrimitiveOrWrapper(value.getClass())); - } - - @Override - public String getStreamId() { - return streamId; - } - - public void setStreamId(String streamId) { - this.streamId = streamId; - } - - public void setSourceType(String sourceType) { - this.sourceType = sourceType; - } -}
http://git-wip-us.apache.org/repos/asf/metron/blob/3d84ea42/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ManualFlushSignal.java ---------------------------------------------------------------------- diff --git a/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ManualFlushSignal.java b/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ManualFlushSignal.java deleted file mode 100644 index d8e9539..0000000 --- a/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ManualFlushSignal.java +++ /dev/null @@ -1,54 +0,0 @@ -/* - * Licensed to the Apache Software Foundation (ASF) under one - * or more contributor license agreements. See the NOTICE file - * distributed with this work for additional information - * regarding copyright ownership. The ASF licenses this file - * to you under the Apache License, Version 2.0 (the - * "License"); you may not use this file except in compliance - * with the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - * - */ -package org.apache.metron.profiler.bolt; - -/** - * Signals that a flush should occur. - * - * <p>The flush signal can be turned on or off like a switch as needed. Most useful for testing. - */ -public class ManualFlushSignal implements FlushSignal { - - private boolean flushNow = false; - - public void setFlushNow(boolean flushNow) { - this.flushNow = flushNow; - } - - @Override - public boolean isTimeToFlush() { - return flushNow; - } - - @Override - public void update(long timestamp) { - // nothing to do - } - - @Override - public void reset() { - // nothing to do. - } - - @Override - public long currentTimeMillis() { - // not needed - return 0; - } -} http://git-wip-us.apache.org/repos/asf/metron/blob/3d84ea42/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileBuilderBolt.java ---------------------------------------------------------------------- diff --git a/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileBuilderBolt.java b/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileBuilderBolt.java deleted file mode 100644 index f9c0edd..0000000 --- a/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileBuilderBolt.java +++ /dev/null @@ -1,509 +0,0 @@ -/* - * - * Licensed to the Apache Software Foundation (ASF) under one - * or more contributor license agreements. See the NOTICE file - * distributed with this work for additional information - * regarding copyright ownership. The ASF licenses this file - * to you under the Apache License, Version 2.0 (the - * "License"); you may not use this file except in compliance - * with the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - * - */ - -package org.apache.metron.profiler.bolt; - -import org.apache.commons.collections4.CollectionUtils; -import org.apache.curator.RetryPolicy; -import org.apache.curator.framework.CuratorFramework; -import org.apache.curator.framework.CuratorFrameworkFactory; -import org.apache.curator.framework.recipes.cache.TreeCacheEvent; -import org.apache.curator.retry.ExponentialBackoffRetry; -import org.apache.metron.common.Constants; -import org.apache.metron.common.configuration.ConfigurationType; -import org.apache.metron.common.configuration.ConfigurationsUtils; -import org.apache.metron.common.configuration.profiler.ProfileConfig; -import org.apache.metron.common.configuration.profiler.ProfilerConfigurations; -import org.apache.metron.common.zookeeper.configurations.ConfigurationsUpdater; -import org.apache.metron.common.zookeeper.configurations.ProfilerUpdater; -import org.apache.metron.common.zookeeper.configurations.Reloadable; -import org.apache.metron.profiler.DefaultMessageDistributor; -import org.apache.metron.profiler.MessageDistributor; -import org.apache.metron.profiler.MessageRoute; -import org.apache.metron.profiler.ProfileMeasurement; -import org.apache.metron.stellar.common.utils.ConversionUtils; -import org.apache.metron.stellar.dsl.Context; -import org.apache.metron.zookeeper.SimpleEventListener; -import org.apache.metron.zookeeper.ZKCache; -import org.apache.storm.task.OutputCollector; -import org.apache.storm.task.TopologyContext; -import org.apache.storm.topology.OutputFieldsDeclarer; -import org.apache.storm.topology.base.BaseWindowedBolt; -import org.apache.storm.tuple.Tuple; -import org.apache.storm.windowing.TupleWindow; -import org.json.simple.JSONObject; -import org.json.simple.parser.JSONParser; -import org.slf4j.Logger; -import org.slf4j.LoggerFactory; - -import java.lang.invoke.MethodHandles; -import java.util.ArrayList; -import java.util.List; -import java.util.Map; -import java.util.concurrent.Executors; -import java.util.concurrent.ScheduledExecutorService; -import java.util.concurrent.TimeUnit; - -import static java.lang.String.format; -import static org.apache.metron.profiler.bolt.ProfileSplitterBolt.ENTITY_TUPLE_FIELD; -import static org.apache.metron.profiler.bolt.ProfileSplitterBolt.MESSAGE_TUPLE_FIELD; -import static org.apache.metron.profiler.bolt.ProfileSplitterBolt.PROFILE_TUPLE_FIELD; -import static org.apache.metron.profiler.bolt.ProfileSplitterBolt.TIMESTAMP_TUPLE_FIELD; - -/** - * A Storm bolt that is responsible for building a profile. - * - * <p>This bolt maintains the state required to build a Profile. When the window - * period expires, the data is summarized as a {@link ProfileMeasurement}, all state is - * flushed, and the {@link ProfileMeasurement} is emitted. - */ -public class ProfileBuilderBolt extends BaseWindowedBolt implements Reloadable { - - protected static final Logger LOG = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass()); - - private OutputCollector collector; - - /** - * The URL to connect to Zookeeper. - */ - private String zookeeperUrl; - - /** - * The Zookeeper client connection. - */ - protected CuratorFramework zookeeperClient; - - /** - * The Zookeeper cache. - */ - protected ZKCache zookeeperCache; - - /** - * Manages configuration for the Profiler. - */ - private ProfilerConfigurations configurations; - - /** - * The duration of each profile period in milliseconds. - */ - private long periodDurationMillis; - - /** - * The duration of Storm's event window. - */ - private long windowDurationMillis; - - /** - * If a message has not been applied to a Profile in this number of milliseconds, - * the Profile will be forgotten and its resources will be cleaned up. - * - * <p>WARNING: The TTL must be at least greater than the period duration. - */ - private long profileTimeToLiveMillis; - - /** - * The maximum number of {@link MessageRoute} routes that will be maintained by - * this bolt. After this value is exceeded, lesser used routes will be evicted - * from the internal cache. - */ - private long maxNumberOfRoutes; - - /** - * Distributes messages to the profile builders. - * - * <p>Since expired profiles are flushed on a separate thread, all access to this - * {@code MessageDistributor} needs to be protected. - */ - private MessageDistributor messageDistributor; - - /** - * Parses JSON messages. - */ - private transient JSONParser parser; - - /** - * Responsible for emitting {@link ProfileMeasurement} values. - * - * <p>The {@link ProfileMeasurement} values generated by a profile can be written to - * multiple endpoints like HBase or Kafka. Each endpoint is handled by a separate - * {@link ProfileMeasurementEmitter}. - */ - private List<ProfileMeasurementEmitter> emitters; - - /** - * Signals when it is time to flush the active profiles. - */ - private FlushSignal activeFlushSignal; - - /** - * An executor that flushes expired profiles at a regular interval on a separate - * thread. - * - * <p>Flushing expired profiles ensures that any profiles that stop receiving messages - * for an extended period of time will continue to be flushed. - * - * <p>This introduces concurrency issues as the bolt is no longer single threaded. Due - * to this, all access to the {@code MessageDistributor} needs to be protected. - */ - private transient ScheduledExecutorService flushExpiredExecutor; - - public ProfileBuilderBolt() { - this.emitters = new ArrayList<>(); - } - - @Override - public void prepare(Map stormConf, TopologyContext context, OutputCollector collector) { - super.prepare(stormConf, context, collector); - - if(periodDurationMillis <= 0) { - throw new IllegalArgumentException("expect 'profiler.period.duration' >= 0"); - } - if(profileTimeToLiveMillis <= 0) { - throw new IllegalArgumentException("expect 'profiler.ttl' >= 0"); - } - if(profileTimeToLiveMillis < periodDurationMillis) { - throw new IllegalArgumentException("expect 'profiler.ttl' >= 'profiler.period.duration'"); - } - if(maxNumberOfRoutes <= 0) { - throw new IllegalArgumentException("expect 'profiler.max.routes.per.bolt' > 0"); - } - if(windowDurationMillis <= 0) { - throw new IllegalArgumentException("expect 'profiler.window.duration' > 0"); - } - if(windowDurationMillis > periodDurationMillis) { - throw new IllegalArgumentException("expect 'profiler.period.duration' >= 'profiler.window.duration'"); - } - if(periodDurationMillis % windowDurationMillis != 0) { - throw new IllegalArgumentException("expect 'profiler.period.duration' % 'profiler.window.duration' == 0"); - } - - this.collector = collector; - this.parser = new JSONParser(); - this.messageDistributor = new DefaultMessageDistributor(periodDurationMillis, profileTimeToLiveMillis, maxNumberOfRoutes); - this.configurations = new ProfilerConfigurations(); - this.activeFlushSignal = new FixedFrequencyFlushSignal(periodDurationMillis); - setupZookeeper(); - startFlushingExpiredProfiles(); - } - - @Override - public void cleanup() { - try { - zookeeperCache.close(); - zookeeperClient.close(); - flushExpiredExecutor.shutdown(); - - } catch(Throwable e) { - LOG.error("Exception when cleaning up", e); - } - } - - /** - * Setup connectivity to Zookeeper which provides the necessary configuration for the bolt. - */ - private void setupZookeeper() { - try { - if (zookeeperClient == null) { - RetryPolicy retryPolicy = new ExponentialBackoffRetry(1000, 3); - zookeeperClient = CuratorFrameworkFactory.newClient(zookeeperUrl, retryPolicy); - } - zookeeperClient.start(); - - // this is temporary to ensure that any validation passes. the individual bolt - // will reinitialize stellar to dynamically pull from zookeeper. - ConfigurationsUtils.setupStellarStatically(zookeeperClient); - if (zookeeperCache == null) { - ConfigurationsUpdater<ProfilerConfigurations> updater = createUpdater(); - SimpleEventListener listener = new SimpleEventListener.Builder() - .with( updater::update, TreeCacheEvent.Type.NODE_ADDED, TreeCacheEvent.Type.NODE_UPDATED) - .with( updater::delete, TreeCacheEvent.Type.NODE_REMOVED) - .build(); - zookeeperCache = new ZKCache.Builder() - .withClient(zookeeperClient) - .withListener(listener) - .withRoot(Constants.ZOOKEEPER_TOPOLOGY_ROOT) - .build(); - updater.forceUpdate(zookeeperClient); - zookeeperCache.start(); - } - } catch (Exception e) { - LOG.error(e.getMessage(), e); - throw new RuntimeException(e); - } - } - - protected ConfigurationsUpdater<ProfilerConfigurations> createUpdater() { - return new ProfilerUpdater(this, this::getConfigurations); - } - - public ProfilerConfigurations getConfigurations() { - return configurations; - } - - @Override - public void reloadCallback(String name, ConfigurationType type) { - // nothing to do - } - - @Override - public void declareOutputFields(OutputFieldsDeclarer declarer) { - - if(emitters.size() == 0) { - throw new IllegalStateException("At least one destination handler must be defined."); - } - - // allow each emitter to define its own stream - emitters.forEach(emitter -> emitter.declareOutputFields(declarer)); - } - - private Context getStellarContext() { - - Map<String, Object> global = getConfigurations().getGlobalConfig(); - return new Context.Builder() - .with(Context.Capabilities.ZOOKEEPER_CLIENT, () -> zookeeperClient) - .with(Context.Capabilities.GLOBAL_CONFIG, () -> global) - .with(Context.Capabilities.STELLAR_CONFIG, () -> global) - .build(); - } - - @Override - public void execute(TupleWindow window) { - - LOG.debug("Tuple window contains {} tuple(s), {} expired, {} new", - CollectionUtils.size(window.get()), - CollectionUtils.size(window.getExpired()), - CollectionUtils.size(window.getNew())); - - try { - - // handle each tuple in the window - for(Tuple tuple : window.get()) { - handleMessage(tuple); - } - - // time to flush active profiles? - if(activeFlushSignal.isTimeToFlush()) { - flushActive(); - } - - } catch (Throwable e) { - - LOG.error("Unexpected error", e); - collector.reportError(e); - } - } - - /** - * Flush all active profiles. - */ - protected void flushActive() { - activeFlushSignal.reset(); - - // flush the active profiles - List<ProfileMeasurement> measurements; - synchronized(messageDistributor) { - measurements = messageDistributor.flush(); - emitMeasurements(measurements); - } - - LOG.debug("Flushed active profiles and found {} measurement(s).", measurements.size()); - - } - - /** - * Flushes all expired profiles. - * - * <p>If a profile has not received a message for an extended period of time then it is - * marked as expired. Periodically we need to flush these expired profiles to ensure - * that their state is not lost. - */ - protected void flushExpired() { - - // flush the expired profiles - List<ProfileMeasurement> measurements; - synchronized (messageDistributor) { - measurements = messageDistributor.flushExpired(); - emitMeasurements(measurements); - } - - LOG.debug("Flushed expired profiles and found {} measurement(s).", measurements.size()); - } - - /** - * Handles the processing of a single tuple. - * - * @param input The tuple containing a telemetry message. - */ - private void handleMessage(Tuple input) { - - // crack open the tuple - JSONObject message = getField(MESSAGE_TUPLE_FIELD, input, JSONObject.class); - ProfileConfig definition = getField(PROFILE_TUPLE_FIELD, input, ProfileConfig.class); - String entity = getField(ENTITY_TUPLE_FIELD, input, String.class); - Long timestamp = getField(TIMESTAMP_TUPLE_FIELD, input, Long.class); - - // keep track of time - activeFlushSignal.update(timestamp); - - // distribute the message - MessageRoute route = new MessageRoute(definition, entity, message, timestamp); - synchronized (messageDistributor) { - messageDistributor.distribute(route, getStellarContext()); - } - - LOG.debug("Message distributed: profile={}, entity={}, timestamp={}", definition.getProfile(), entity, timestamp); - } - - /** - * Handles the {@code ProfileMeasurement}s that are created when a profile is flushed. - * - * @param measurements The measurements to handle. - */ - private void emitMeasurements(List<ProfileMeasurement> measurements) { - - // flush each profile - for(ProfileMeasurement measurement: measurements) { - - // allow each 'emitter' to emit the measurement - for (ProfileMeasurementEmitter emitter : emitters) { - emitter.emit(measurement, collector); - - LOG.debug("Measurement emitted; stream={}, profile={}, entity={}, value={}, start={}, end={}, duration={}, period={}", - emitter.getStreamId(), - measurement.getProfileName(), - measurement.getEntity(), - measurement.getProfileValue(), - measurement.getPeriod().getStartTimeMillis(), - measurement.getPeriod().getEndTimeMillis(), - measurement.getPeriod().getDurationMillis(), - measurement.getPeriod().getPeriod()); - } - } - - LOG.debug("Emitted {} measurement(s).", measurements.size()); - } - - /** - * Retrieves an expected field from a Tuple. If the field is missing an exception is thrown to - * indicate a fatal error. - * @param fieldName The name of the field. - * @param tuple The tuple from which to retrieve the field. - * @param clazz The type of the field value. - * @param <T> The type of the field value. - */ - private <T> T getField(String fieldName, Tuple tuple, Class<T> clazz) { - - T value = ConversionUtils.convert(tuple.getValueByField(fieldName), clazz); - if(value == null) { - throw new IllegalStateException(format("Invalid tuple: missing or invalid field '%s'", fieldName)); - } - - return value; - } - - /** - * Creates a separate thread that regularly flushes expired profiles. - */ - private void startFlushingExpiredProfiles() { - - long initialDelay = profileTimeToLiveMillis; - long period = profileTimeToLiveMillis; - flushExpiredExecutor = Executors.newSingleThreadScheduledExecutor(); - flushExpiredExecutor.scheduleAtFixedRate(() -> flushExpired(), initialDelay, period, TimeUnit.MILLISECONDS); - } - - @Override - public BaseWindowedBolt withTumblingWindow(BaseWindowedBolt.Duration duration) { - - // need to capture the window duration to validate it along with other profiler settings - this.windowDurationMillis = duration.value; - return super.withTumblingWindow(duration); - } - - public long getPeriodDurationMillis() { - return periodDurationMillis; - } - - public ProfileBuilderBolt withPeriodDurationMillis(long periodDurationMillis) { - this.periodDurationMillis = periodDurationMillis; - return this; - } - - public ProfileBuilderBolt withPeriodDuration(int duration, TimeUnit units) { - return withPeriodDurationMillis(units.toMillis(duration)); - } - - public ProfileBuilderBolt withProfileTimeToLiveMillis(long timeToLiveMillis) { - this.profileTimeToLiveMillis = timeToLiveMillis; - return this; - } - - public long getWindowDurationMillis() { - return windowDurationMillis; - } - - public ProfileBuilderBolt withProfileTimeToLive(int duration, TimeUnit units) { - return withProfileTimeToLiveMillis(units.toMillis(duration)); - } - - public ProfileBuilderBolt withEmitter(ProfileMeasurementEmitter emitter) { - this.emitters.add(emitter); - return this; - } - - public MessageDistributor getMessageDistributor() { - return messageDistributor; - } - - public ProfileBuilderBolt withZookeeperUrl(String zookeeperUrl) { - this.zookeeperUrl = zookeeperUrl; - return this; - } - - public ProfileBuilderBolt withZookeeperClient(CuratorFramework zookeeperClient) { - this.zookeeperClient = zookeeperClient; - return this; - } - - public ProfileBuilderBolt withZookeeperCache(ZKCache zookeeperCache) { - this.zookeeperCache = zookeeperCache; - return this; - } - - public ProfileBuilderBolt withProfilerConfigurations(ProfilerConfigurations configurations) { - this.configurations = configurations; - return this; - } - - public ProfileBuilderBolt withMaxNumberOfRoutes(long maxNumberOfRoutes) { - this.maxNumberOfRoutes = maxNumberOfRoutes; - return this; - } - - public ProfileBuilderBolt withFlushSignal(FlushSignal flushSignal) { - this.activeFlushSignal = flushSignal; - return this; - } - - public ProfileBuilderBolt withMessageDistributor(MessageDistributor messageDistributor) { - this.messageDistributor = messageDistributor; - return this; - } -} http://git-wip-us.apache.org/repos/asf/metron/blob/3d84ea42/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileHBaseMapper.java ---------------------------------------------------------------------- diff --git a/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileHBaseMapper.java b/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileHBaseMapper.java deleted file mode 100644 index 5448e39..0000000 --- a/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileHBaseMapper.java +++ /dev/null @@ -1,117 +0,0 @@ -/* - * - * Licensed to the Apache Software Foundation (ASF) under one - * or more contributor license agreements. See the NOTICE file - * distributed with this work for additional information - * regarding copyright ownership. The ASF licenses this file - * to you under the Apache License, Version 2.0 (the - * "License"); you may not use this file except in compliance - * with the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - * - */ - -package org.apache.metron.profiler.bolt; - -import org.apache.metron.common.configuration.profiler.ProfileConfig; -import org.apache.metron.hbase.bolt.mapper.ColumnList; -import org.apache.metron.hbase.bolt.mapper.HBaseMapper; -import org.apache.metron.profiler.ProfileMeasurement; -import org.apache.metron.profiler.hbase.ColumnBuilder; -import org.apache.metron.profiler.hbase.RowKeyBuilder; -import org.apache.metron.profiler.hbase.SaltyRowKeyBuilder; -import org.apache.metron.profiler.hbase.ValueOnlyColumnBuilder; -import org.apache.storm.tuple.Tuple; - -import java.util.Optional; -import java.util.concurrent.TimeUnit; - -/** - * An HbaseMapper that defines how a ProfileMeasurement is persisted within an HBase table. - */ -public class ProfileHBaseMapper implements HBaseMapper { - - /** - * Generates the row keys necessary to store profile data in HBase. - */ - private RowKeyBuilder rowKeyBuilder; - - /** - * Generates the ColumnList necesary to store profile data in HBase. - */ - private ColumnBuilder columnBuilder; - - public ProfileHBaseMapper() { - setRowKeyBuilder(new SaltyRowKeyBuilder()); - setColumnBuilder(new ValueOnlyColumnBuilder()); - } - - public ProfileHBaseMapper(RowKeyBuilder rowKeyBuilder, ColumnBuilder columnBuilder) { - setRowKeyBuilder(rowKeyBuilder); - setColumnBuilder(columnBuilder); - } - - /** - * Defines the HBase row key that will be used when writing the data from a - * tuple to HBase. - * - * @param tuple The tuple to map to HBase. - */ - @Override - public byte[] rowKey(Tuple tuple) { - ProfileMeasurement measurement = (ProfileMeasurement) tuple.getValueByField("measurement"); - return rowKeyBuilder.rowKey(measurement); - } - - /** - * Defines the columnar structure that will be used when writing the data - * from a tuple to HBase. - * - * @param tuple The tuple to map to HBase. - */ - @Override - public ColumnList columns(Tuple tuple) { - ProfileMeasurement measurement = (ProfileMeasurement) tuple.getValueByField("measurement"); - return columnBuilder.columns(measurement); - } - - /** - * Defines the TTL (time-to-live) that will be used when writing the data - * from a tuple to HBase. After the TTL, the data will expire and will be - * purged. - * - * @param tuple The tuple to map to HBase. - * @return The TTL in milliseconds. - */ - @Override - public Optional<Long> getTTL(Tuple tuple) { - Optional<Long> expiresMillis = Optional.empty(); - - ProfileMeasurement measurement = (ProfileMeasurement) tuple.getValueByField("measurement"); - ProfileConfig profileConfig = measurement.getDefinition(); - - if(profileConfig.getExpires() != null) { - - // a profile's `expires` field is in days, but hbase expects milliseconds - long expiresDays = profileConfig.getExpires(); - expiresMillis = Optional.of(TimeUnit.DAYS.toMillis(expiresDays)); - } - - return expiresMillis; - } - - public void setRowKeyBuilder(RowKeyBuilder rowKeyBuilder) { - this.rowKeyBuilder = rowKeyBuilder; - } - - public void setColumnBuilder(ColumnBuilder columnBuilder) { - this.columnBuilder = columnBuilder; - } -} http://git-wip-us.apache.org/repos/asf/metron/blob/3d84ea42/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileMeasurementEmitter.java ---------------------------------------------------------------------- diff --git a/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileMeasurementEmitter.java b/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileMeasurementEmitter.java deleted file mode 100644 index e1fe4e1..0000000 --- a/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileMeasurementEmitter.java +++ /dev/null @@ -1,59 +0,0 @@ -/* - * Licensed to the Apache Software Foundation (ASF) under one - * or more contributor license agreements. See the NOTICE file - * distributed with this work for additional information - * regarding copyright ownership. The ASF licenses this file - * to you under the Apache License, Version 2.0 (the - * "License"); you may not use this file except in compliance - * with the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - * - */ -package org.apache.metron.profiler.bolt; - -import org.apache.metron.profiler.ProfileMeasurement; -import org.apache.storm.task.OutputCollector; -import org.apache.storm.topology.OutputFieldsDeclarer; - -/** - * Handles the mechanics of emitting a {@link ProfileMeasurement} to an output - * stream. - * - * <p>The Profiler allows the measurements produced by a profile to be written to - * multiple endpoints such as HBase and Kafka. Each of these endpoints will have - * a unique stream that the measurements are written to. - * - * <p>Implementors of this interface are responsible for defining and managing the - * output stream for a specific endpoint. - */ -public interface ProfileMeasurementEmitter { - - /** - * Each destination leverages a unique stream. This method defines - * the unique stream identifier. - * - * The stream identifier must also be declared within the topology - * definition. - */ - String getStreamId(); - - /** - * Declares the output fields for the stream. - * @param declarer - */ - void declareOutputFields(OutputFieldsDeclarer declarer); - - /** - * Emit the measurement. - * @param measurement The measurement to emit. - * @param collector The output collector. - */ - void emit(ProfileMeasurement measurement, OutputCollector collector); -} http://git-wip-us.apache.org/repos/asf/metron/blob/3d84ea42/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileSplitterBolt.java ---------------------------------------------------------------------- diff --git a/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileSplitterBolt.java b/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileSplitterBolt.java deleted file mode 100644 index f73a9f1..0000000 --- a/metron-analytics/metron-profiler/src/main/java/org/apache/metron/profiler/bolt/ProfileSplitterBolt.java +++ /dev/null @@ -1,232 +0,0 @@ -/* - * - * Licensed to the Apache Software Foundation (ASF) under one - * or more contributor license agreements. See the NOTICE file - * distributed with this work for additional information - * regarding copyright ownership. The ASF licenses this file - * to you under the Apache License, Version 2.0 (the - * "License"); you may not use this file except in compliance - * with the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - * - */ - -package org.apache.metron.profiler.bolt; - -import org.apache.metron.common.bolt.ConfiguredProfilerBolt; -import org.apache.metron.common.configuration.profiler.ProfilerConfig; -import org.apache.metron.profiler.DefaultMessageRouter; -import org.apache.metron.profiler.MessageRoute; -import org.apache.metron.profiler.MessageRouter; -import org.apache.metron.profiler.clock.Clock; -import org.apache.metron.profiler.clock.ClockFactory; -import org.apache.metron.profiler.clock.DefaultClockFactory; -import org.apache.metron.stellar.dsl.Context; -import org.apache.storm.task.OutputCollector; -import org.apache.storm.task.TopologyContext; -import org.apache.storm.topology.OutputFieldsDeclarer; -import org.apache.storm.tuple.Fields; -import org.apache.storm.tuple.Tuple; -import org.apache.storm.tuple.Values; -import org.json.simple.JSONObject; -import org.json.simple.parser.JSONParser; -import org.json.simple.parser.ParseException; -import org.slf4j.Logger; -import org.slf4j.LoggerFactory; - -import java.io.UnsupportedEncodingException; -import java.lang.invoke.MethodHandles; -import java.util.List; -import java.util.Map; -import java.util.Optional; - -/** - * The Storm bolt responsible for filtering incoming messages and directing - * each to the downstream bolts responsible for building a Profile. - */ -public class ProfileSplitterBolt extends ConfiguredProfilerBolt { - - protected static final Logger LOG = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass()); - - /** - * The name of the tuple field containing the entity. - * - * This is the result of executing a profile's 'entity' Stellar expression within - * the context of the telemetry message. - */ - protected static final String ENTITY_TUPLE_FIELD = "entity"; - - /** - * The name of the tuple field containing the profile definition. - */ - protected static final String PROFILE_TUPLE_FIELD = "profile"; - - /** - * The name of the tuple field containing the telemetry message. - */ - protected static final String MESSAGE_TUPLE_FIELD = "message"; - - /** - * The name of the tuple field containing the timestamp of the telemetry message. - * - * <p>If a 'timestampField' has been configured, the timestamp was extracted - * from a field within the telemetry message. This enables event time processing. - * - * <p>If a 'timestampField' has not been configured, then the Profiler uses - * processing time and the timestamp originated from the system clock. - */ - protected static final String TIMESTAMP_TUPLE_FIELD = "timestamp"; - - private OutputCollector collector; - - /** - * JSON parser. - */ - private transient JSONParser parser; - - /** - * The router responsible for routing incoming messages. - */ - private transient MessageRouter router; - - /** - * @param zookeeperUrl The Zookeeper URL that contains the configuration for this bolt. - */ - public ProfileSplitterBolt(String zookeeperUrl) { - super(zookeeperUrl); - } - - @Override - public void prepare(Map stormConf, TopologyContext context, OutputCollector collector) { - super.prepare(stormConf, context, collector); - this.collector = collector; - this.parser = new JSONParser(); - this.router = new DefaultMessageRouter(getStellarContext()); - } - - public Context getStellarContext() { - Map<String, Object> global = getConfigurations().getGlobalConfig(); - return new Context.Builder() - .with(Context.Capabilities.ZOOKEEPER_CLIENT, () -> client) - .with(Context.Capabilities.GLOBAL_CONFIG, () -> global) - .with(Context.Capabilities.STELLAR_CONFIG, () -> global) - .build(); - } - - /** - * This bolt consumes telemetry messages and determines if the message is needed - * by any of the profiles. The message is then routed to one or more downstream - * bolts that are responsible for building each profile - * - * <p>The outgoing tuples are timestamped so that Storm's window and event-time - * processing functionality can recognize the time of each message. - * - * <p>The timestamp that is attached to each outgoing tuple is what decides if - * the Profiler is operating on processing time or event time. - * - * @param input The tuple. - */ - @Override - public void execute(Tuple input) { - try { - doExecute(input); - - } catch (Throwable t) { - LOG.error("Unexpected error", t); - collector.reportError(t); - - } finally { - collector.ack(input); - } - } - - private void doExecute(Tuple input) throws ParseException, UnsupportedEncodingException { - - // retrieve the input message - byte[] data = input.getBinary(0); - if(data == null) { - LOG.debug("Received null message. Nothing to do."); - return; - } - - // ensure there is a valid profiler configuration - ProfilerConfig config = getProfilerConfig(); - if(config == null || getProfilerConfig().getProfiles().size() == 0) { - LOG.debug("No Profiler configuration found. Nothing to do."); - return; - } - - JSONObject message = (JSONObject) parser.parse(new String(data, "UTF8")); - routeMessage(input, message, config); - } - - /** - * Route a message based on the Profiler configuration. - * @param input The input tuple on which to anchor. - * @param message The telemetry message. - * @param config The Profiler configuration. - */ - private void routeMessage(Tuple input, JSONObject message, ProfilerConfig config) { - - // emit a tuple for each 'route' - List<MessageRoute> routes = router.route(message, config, getStellarContext()); - for (MessageRoute route : routes) { - - Values values = createValues(route); - collector.emit(input, values); - - LOG.debug("Found route for message; profile={}, entity={}, timestamp={}", - route.getProfileDefinition().getProfile(), - route.getEntity(), - route.getTimestamp()); - } - - LOG.debug("Found {} route(s) for message", routes.size()); - } - - /** - * Each emitted tuple contains the following fields. - * <p> - * <ol> - * <li>message - The message containing JSON-formatted data that needs applied to a profile. - * <li>timestamp - The timestamp of the message. - * <li>entity - The name of the entity. The actual result of executing the Stellar expression. - * <li>profile - The profile definition that the message needs applied to. - * </ol> - * <p> - */ - @Override - public void declareOutputFields(OutputFieldsDeclarer declarer) { - - // the order here must match 'createValues' - Fields fields = new Fields(MESSAGE_TUPLE_FIELD, TIMESTAMP_TUPLE_FIELD, ENTITY_TUPLE_FIELD, PROFILE_TUPLE_FIELD); - declarer.declare(fields); - } - - /** - * Creates the {@link Values} attached to the outgoing tuple. - * - * @param route The route the message must take. - * @return - */ - private Values createValues(MessageRoute route) { - - // the order here must match `declareOutputFields` - return new Values(route.getMessage(), route.getTimestamp(), route.getEntity(), route.getProfileDefinition()); - } - - protected MessageRouter getMessageRouter() { - return router; - } - - public void setRouter(MessageRouter router) { - this.router = router; - } -} http://git-wip-us.apache.org/repos/asf/metron/blob/3d84ea42/metron-analytics/metron-profiler/src/main/resources/META-INF/LICENSE ---------------------------------------------------------------------- diff --git a/metron-analytics/metron-profiler/src/main/resources/META-INF/LICENSE b/metron-analytics/metron-profiler/src/main/resources/META-INF/LICENSE deleted file mode 100644 index dd73ae9..0000000 --- a/metron-analytics/metron-profiler/src/main/resources/META-INF/LICENSE +++ /dev/null @@ -1,604 +0,0 @@ -Apache License - Version 2.0, January 2004 - http://www.apache.org/licenses/ - - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - - 1. Definitions. - - "License" shall mean the terms and conditions for use, reproduction, - and distribution as defined by Sections 1 through 9 of this document. - - "Licensor" shall mean the copyright owner or entity authorized by - the copyright owner that is granting the License. - - "Legal Entity" shall mean the union of the acting entity and all - other entities that control, are controlled by, or are under common - control with that entity. For the purposes of this definition, - "control" means (i) the power, direct or indirect, to cause the - direction or management of such entity, whether by contract or - otherwise, or (ii) ownership of fifty percent (50%) or more of the - outstanding shares, or (iii) beneficial ownership of such entity. - - "You" (or "Your") shall mean an individual or Legal Entity - exercising permissions granted by this License. - - "Source" form shall mean the preferred form for making modifications, - including but not limited to software source code, documentation - source, and configuration files. - - "Object" form shall mean any form resulting from mechanical - transformation or translation of a Source form, including but - not limited to compiled object code, generated documentation, - and conversions to other media types. - - "Work" shall mean the work of authorship, whether in Source or - Object form, made available under the License, as indicated by a - copyright notice that is included in or attached to the work - (an example is provided in the Appendix below). - - "Derivative Works" shall mean any work, whether in Source or Object - form, that is based on (or derived from) the Work and for which the - editorial revisions, annotations, elaborations, or other modifications - represent, as a whole, an original work of authorship. For the purposes - of this License, Derivative Works shall not include works that remain - separable from, or merely link (or bind by name) to the interfaces of, - the Work and Derivative Works thereof. - - "Contribution" shall mean any work of authorship, including - the original version of the Work and any modifications or additions - to that Work or Derivative Works thereof, that is intentionally - submitted to Licensor for inclusion in the Work by the copyright owner - or by an individual or Legal Entity authorized to submit on behalf of - the copyright owner. For the purposes of this definition, "submitted" - means any form of electronic, verbal, or written communication sent - to the Licensor or its representatives, including but not limited to - communication on electronic mailing lists, source code control systems, - and issue tracking systems that are managed by, or on behalf of, the - Licensor for the purpose of discussing and improving the Work, but - excluding communication that is conspicuously marked or otherwise - designated in writing by the copyright owner as "Not a Contribution." - - "Contributor" shall mean Licensor and any individual or Legal Entity - on behalf of whom a Contribution has been received by Licensor and - subsequently incorporated within the Work. - - 2. Grant of Copyright License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - copyright license to reproduce, prepare Derivative Works of, - publicly display, publicly perform, sublicense, and distribute the - Work and such Derivative Works in Source or Object form. - - 3. Grant of Patent License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - (except as stated in this section) patent license to make, have made, - use, offer to sell, sell, import, and otherwise transfer the Work, - where such license applies only to those patent claims licensable - by such Contributor that are necessarily infringed by their - Contribution(s) alone or by combination of their Contribution(s) - with the Work to which such Contribution(s) was submitted. If You - institute patent litigation against any entity (including a - cross-claim or counterclaim in a lawsuit) alleging that the Work - or a Contribution incorporated within the Work constitutes direct - or contributory patent infringement, then any patent licenses - granted to You under this License for that Work shall terminate - as of the date such litigation is filed. - - 4. Redistribution. You may reproduce and distribute copies of the - Work or Derivative Works thereof in any medium, with or without - modifications, and in Source or Object form, provided that You - meet the following conditions: - - (a) You must give any other recipients of the Work or - Derivative Works a copy of this License; and - - (b) You must cause any modified files to carry prominent notices - stating that You changed the files; and - - (c) You must retain, in the Source form of any Derivative Works - that You distribute, all copyright, patent, trademark, and - attribution notices from the Source form of the Work, - excluding those notices that do not pertain to any part of - the Derivative Works; and - - (d) If the Work includes a "NOTICE" text file as part of its - distribution, then any Derivative Works that You distribute must - include a readable copy of the attribution notices contained - within such NOTICE file, excluding those notices that do not - pertain to any part of the Derivative Works, in at least one - of the following places: within a NOTICE text file distributed - as part of the Derivative Works; within the Source form or - documentation, if provided along with the Derivative Works; or, - within a display generated by the Derivative Works, if and - wherever such third-party notices normally appear. The contents - of the NOTICE file are for informational purposes only and - do not modify the License. You may add Your own attribution - notices within Derivative Works that You distribute, alongside - or as an addendum to the NOTICE text from the Work, provided - that such additional attribution notices cannot be construed - as modifying the License. - - You may add Your own copyright statement to Your modifications and - may provide additional or different license terms and conditions - for use, reproduction, or distribution of Your modifications, or - for any such Derivative Works as a whole, provided Your use, - reproduction, and distribution of the Work otherwise complies with - the conditions stated in this License. - - 5. Submission of Contributions. Unless You explicitly state otherwise, - any Contribution intentionally submitted for inclusion in the Work - by You to the Licensor shall be under the terms and conditions of - this License, without any additional terms or conditions. - Notwithstanding the above, nothing herein shall supersede or modify - the terms of any separate license agreement you may have executed - with Licensor regarding such Contributions. - - 6. Trademarks. This License does not grant permission to use the trade - names, trademarks, service marks, or product names of the Licensor, - except as required for reasonable and customary use in describing the - origin of the Work and reproducing the content of the NOTICE file. - - 7. Disclaimer of Warranty. Unless required by applicable law or - agreed to in writing, Licensor provides the Work (and each - Contributor provides its Contributions) on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or - implied, including, without limitation, any warranties or conditions - of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A - PARTICULAR PURPOSE. You are solely responsible for determining the - appropriateness of using or redistributing the Work and assume any - risks associated with Your exercise of permissions under this License. - - 8. Limitation of Liability. In no event and under no legal theory, - whether in tort (including negligence), contract, or otherwise, - unless required by applicable law (such as deliberate and grossly - negligent acts) or agreed to in writing, shall any Contributor be - liable to You for damages, including any direct, indirect, special, - incidental, or consequential damages of any character arising as a - result of this License or out of the use or inability to use the - Work (including but not limited to damages for loss of goodwill, - work stoppage, computer failure or malfunction, or any and all - other commercial damages or losses), even if such Contributor - has been advised of the possibility of such damages. - - 9. Accepting Warranty or Additional Liability. While redistributing - the Work or Derivative Works thereof, You may choose to offer, - and charge a fee for, acceptance of support, warranty, indemnity, - or other liability obligations and/or rights consistent with this - License. However, in accepting such obligations, You may act only - on Your own behalf and on Your sole responsibility, not on behalf - of any other Contributor, and only if You agree to indemnify, - defend, and hold each Contributor harmless for any liability - incurred by, or claims asserted against, such Contributor by reason - of your accepting any such warranty or additional liability. - - END OF TERMS AND CONDITIONS - - APPENDIX: How to apply the Apache License to your work. - - To apply the Apache License to your work, attach the following - boilerplate notice, with the fields enclosed by brackets "{}" - replaced with your own identifying information. (Don't include - the brackets!) The text should be enclosed in the appropriate - comment syntax for the file format. We also recommend that a - file or class name and description of purpose be included on the - same "printed page" as the copyright notice for easier - identification within third-party archives. - - Copyright {yyyy} {name of copyright owner} - - Licensed under the Apache License, Version 2.0 (the "License"); - you may not use this file except in compliance with the License. - You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. - ------------------------------------------------------------------------------------- - ------------------------------------------------------------------------------------- - BSD ------------------------------------------------------------------------------------- -This product bundles asm 3.1, which is available under a "BSD Software License" license. For details, see http://asm.ow2.org/ -This product bundles protobuf-java 2.5.0, which is available under a "BSD Software License" license. For details, see http://code.google.com/p/protobuf -This product bundles jsch 0.1.42, which is available under a "BSD Software License" license. For details, see http://www.jcraft.com/jsch/ -This product bundles paranamer 2.3, which is available under a "BSD Software License" license. For details, see https://github.com/paul-hammant/paranamer -This product bundles jline 0.9.94, which is available under a "BSD Software License" license. For details, see http://jline.sourceforge.net -This product bundles scala-library 2.10.6, which is available under a "BSD Software License" license. For details, see http://www.scala-lang.org/ -This product bundles xmlenc 0.52, which is available under a "BSD Software License" license. For details, see http://xmlenc.sourceforge.net - - -This product contains a modified version of 'JZlib', a re-implementation of -zlib in pure Java, which can be obtained at: - - * LICENSE: - * license/LICENSE.jzlib.txt (BSD Style License) - * HOMEPAGE: - * http://www.jcraft.com/jzlib/ - - -Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: - -1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. - -2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. - -3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - ------------------------------------------------------------------------------------- - CDDL v1.1 ------------------------------------------------------------------------------------- - -This product bundles jersey-guice 1.9, which is available under a "Common Development and Distribution License v1.1" license. For details, see https://jersey.java.net/ -This product bundles jersey-client 1.9, which is available under a "Common Development and Distribution License v1.1" license. For details, see https://jersey.java.net/ -This product bundles jersey-core 1.9, which is available under a "Common Development and Distribution License v1.1" license. For details, see https://jersey.java.net/ -This product bundles jersey-json 1.9, which is available under a "Common Development and Distribution License v1.1" license. For details, see https://jersey.java.net/ -This product bundles jersey-server 1.9, which is available under a "Common Development and Distribution License v1.1" license. For details, see https://jersey.java.net/ -This product bundles jaxb-impl 2.2.3-1, which is available under a "Common Development and Distribution License" license. For details, see http://jaxb.java.net/ -This product bundles activation 1.1, which is available under a "Common Development and Distribution License v1.0" license. For details, see http://java.sun.com/products/javabeans/jaf/index.jsp -This product bundles jaxb-api 2.2.2, which is available under a "Common Development and Distribution License" license. For details, see https://jaxb.dev.java.net/ -This product bundles stax-api 1.0-2, which is available under a "Common Development and Distribution License v1.0" license. For details, see https://docs.oracle.com/javase/7/docs/api/javax/xml/stream/package-summary.html -OMMON DEVELOPMENT AND DISTRIBUTION LICENSE (CDDL) Version 1.0 - 1. Definitions. - 1.1. "Contributor" means each individual or entity that - creates or contributes to the creation of Modifications. - 1.2. "Contributor Version" means the combination of the - Original Software, prior Modifications used by a - Contributor (if any), and the Modifications made by that - particular Contributor. - 1.3. "Covered Software" means (a) the Original Software, or - (b) Modifications, or (c) the combination of files - containing Original Software with files containing - Modifications, in each case including portions thereof. - 1.4. "Executable" means the Covered Software in any form - other than Source Code. - 1.5. "Initial Developer" means the individual or entity - that first makes Original Software available under this - License. - 1.6. "Larger Work" means a work which combines Covered - Software or portions thereof with code not governed by the - terms of this License. - 1.7. "License" means this document. - 1.8. "Licensable" means having the right to grant, to the - maximum extent possible, whether at the time of the initial - grant or subsequently acquired, any and all of the rights - conveyed herein. - 1.9. "Modifications" means the Source Code and Executable - form of any of the following: - A. Any file that results from an addition to, - deletion from or modification of the contents of a - file containing Original Software or previous - Modifications; - B. Any new file that contains any part of the - Original Software or previous Modification; or - C. Any new file that is contributed or otherwise made - available under the terms of this License. - 1.10. "Original Software" means the Source Code and - Executable form of computer software code that is - originally released under this License. - 1.11. "Patent Claims" means any patent claim(s), now owned - or hereafter acquired, including without limitation, - method, process, and apparatus claims, in any patent - Licensable by grantor. - 1.12. "Source Code" means (a) the common form of computer - software code in which modifications are made and (b) - associated documentation included in or with such code. - 1.13. "You" (or "Your") means an individual or a legal - entity exercising rights under, and complying with all of - the terms of, this License. For legal entities, "You" - includes any entity which controls, is controlled by, or is - under common control with You. For purposes of this - definition, "control" means (a) the power, direct or - indirect, to cause the direction or management of such - entity, whether by contract or otherwise, or (b) ownership - of more than fifty percent (50%) of the outstanding shares - or beneficial ownership of such entity. - 2. License Grants. - 2.1. The Initial Developer Grant. - Conditioned upon Your compliance with Section 3.1 below and - subject to third party intellectual property claims, the - Initial Developer hereby grants You a world-wide, - royalty-free, non-exclusive license: - (a) under intellectual property rights (other than - patent or trademark) Licensable by Initial Developer, - to use, reproduce, modify, display, perform, - sublicense and distribute the Original Software (or - portions thereof), with or without Modifications, - and/or as part of a Larger Work; and - (b) under Patent Claims infringed by the making, - using or selling of Original Software, to make, have - made, use, practice, sell, and offer for sale, and/or - otherwise dispose of the Original Software (or - portions thereof). - (c) The licenses granted in Sections 2.1(a) and (b) - are effective on the date Initial Developer first - distributes or otherwise makes the Original Software - available to a third party under the terms of this - License. - (d) Notwithstanding Section 2.1(b) above, no patent - license is granted: (1) for code that You delete from - the Original Software, or (2) for infringements - caused by: (i) the modification of the Original - Software, or (ii) the combination of the Original - Software with other software or devices. - 2.2. Contributor Grant. - Conditioned upon Your compliance with Section 3.1 below and - subject to third party intellectual property claims, each - Contributor hereby grants You a world-wide, royalty-free, - non-exclusive license: - (a) under intellectual property rights (other than - patent or trademark) Licensable by Contributor to - use, reproduce, modify, display, perform, sublicense - and distribute the Modifications created by such - Contributor (or portions thereof), either on an - unmodified basis, with other Modifications, as - Covered Software and/or as part of a Larger Work; and - (b) under Patent Claims infringed by the making, - using, or selling of Modifications made by that - Contributor either alone and/or in combination with - its Contributor Version (or portions of such - combination), to make, use, sell, offer for sale, - have made, and/or otherwise dispose of: (1) - Modifications made by that Contributor (or portions - thereof); and (2) the combination of Modifications - made by that Contributor with its Contributor Version - (or portions of such combination). - (c) The licenses granted in Sections 2.2(a) and - 2.2(b) are effective on the date Contributor first - distributes or otherwise makes the Modifications - available to a third party. - (d) Notwithstanding Section 2.2(b) above, no patent - license is granted: (1) for any code that Contributor - has deleted from the Contributor Version; (2) for - infringements caused by: (i) third party - modifications of Contributor Version, or (ii) the - combination of Modifications made by that Contributor - with other software (except as part of the - Contributor Version) or other devices; or (3) under - Patent Claims infringed by Covered Software in the - absence of Modifications made by that Contributor. - 3. Distribution Obligations. - 3.1. Availability of Source Code. - Any Covered Software that You distribute or otherwise make - available in Executable form must also be made available in - Source Code form and that Source Code form must be - distributed only under the terms of this License. You must - include a copy of this License with every copy of the - Source Code form of the Covered Software You distribute or - otherwise make available. You must inform recipients of any - such Covered Software in Executable form as to how they can - obtain such Covered Software in Source Code form in a - reasonable manner on or through a medium customarily used - for software exchange. - 3.2. Modifications. - The Modifications that You create or to which You - contribute are governed by the terms of this License. You - represent that You believe Your Modifications are Your - original creation(s) and/or You have sufficient rights to - grant the rights conveyed by this License. - 3.3. Required Notices. - You must include a notice in each of Your Modifications - that identifies You as the Contributor of the Modification. - You may not remove or alter any copyright, patent or - trademark notices contained within the Covered Software, or - any notices of licensing or any descriptive text giving - attribution to any Contributor or the Initial Developer. - 3.4. Application of Additional Terms. - You may not offer or impose any terms on any Covered - Software in Source Code form that alters or restricts the - applicable version of this License or the recipients' - rights hereunder. You may choose to offer, and to charge a - fee for, warranty, support, indemnity or liability - obligations to one or more recipients of Covered Software. - However, you may do so only on Your own behalf, and not on - behalf of the Initial Developer or any Contributor. You - must make it absolutely clear that any such warranty, - support, indemnity or liability obligation is offered by - You alone, and You hereby agree to indemnify the Initial - Developer and every Contributor for any liability incurred - by the Initial Developer or such Contributor as a result of - warranty, support, indemnity or liability terms You offer. - 3.5. Distribution of Executable Versions. - You may distribute the Executable form of the Covered - Software under the terms of this License or under the terms - of a license of Your choice, which may contain terms - different from this License, provided that You are in - compliance with the terms of this License and that the - license for the Executable form does not attempt to limit - or alter the recipient's rights in the Source Code form - from the rights set forth in this License. If You - distribute the Covered Software in Executable form under a - different license, You must make it absolutely clear that - any terms which differ from this License are offered by You - alone, not by the Initial Developer or Contributor. You - hereby agree to indemnify the Initial Developer and every - Contributor for any liability incurred by the Initial - Developer or such Contributor as a result of any such terms - You offer. - 3.6. Larger Works. - You may create a Larger Work by combining Covered Software - with other code not governed by the terms of this License - and distribute the Larger Work as a single product. In such - a case, You must make sure the requirements of this License - are fulfilled for the Covered Software. - 4. Versions of the License. - 4.1. New Versions. - Sun Microsystems, Inc. is the initial license steward and - may publish revised and/or new versions of this License - from time to time. Each version will be given a - distinguishing version number. Except as provided in - Section 4.3, no one other than the license steward has the - right to modify this License. - 4.2. Effect of New Versions. - You may always continue to use, distribute or otherwise - make the Covered Software available under the terms of the - version of the License under which You originally received - the Covered Software. If the Initial Developer includes a - notice in the Original Software prohibiting it from being - distributed or otherwise made available under any - subsequent version of the License, You must distribute and - make the Covered Software available under the terms of the - version of the License under which You originally received - the Covered Software. Otherwise, You may also choose to - use, distribute or otherwise make the Covered Software - available under the terms of any subsequent version of the - License published by the license steward. - 4.3. Modified Versions. - When You are an Initial Developer and You want to create a - new license for Your Original Software, You may create and - use a modified version of this License if You: (a) rename - the license and remove any references to the name of the - license steward (except to note that the license differs - from this License); and (b) otherwise make it clear that - the license contains terms which differ from this License. - 5. DISCLAIMER OF WARRANTY. - COVERED SOFTWARE IS PROVIDED UNDER THIS LICENSE ON AN "AS IS" - BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, - INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE COVERED - SOFTWARE IS FREE OF DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR - PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY AND - PERFORMANCE OF THE COVERED SOFTWARE IS WITH YOU. SHOULD ANY - COVERED SOFTWARE PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE - INITIAL DEVELOPER OR ANY OTHER CONTRIBUTOR) ASSUME THE COST OF - ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF - WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF - ANY COVERED SOFTWARE IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS - DISCLAIMER. - 6. TERMINATION. - 6.1. This License and the rights granted hereunder will - terminate automatically if You fail to comply with terms - herein and fail to cure such breach within 30 days of - becoming aware of the breach. Provisions which, by their - nature, must remain in effect beyond the termination of - this License shall survive. - 6.2. If You assert a patent infringement claim (excluding - declaratory judgment actions) against Initial Developer or - a Contributor (the Initial Developer or Contributor against - whom You assert such claim is referred to as "Participant") - alleging that the Participant Software (meaning the - Contributor Version where the Participant is a Contributor - or the Original Software where the Participant is the - Initial Developer) directly or indirectly infringes any - patent, then any and all rights granted directly or - indirectly to You by such Participant, the Initial - Developer (if the Initial Developer is not the Participant) - and all Contributors under Sections 2.1 and/or 2.2 of this - License shall, upon 60 days notice from Participant - terminate prospectively and automatically at the expiration - of such 60 day notice period, unless if within such 60 day - period You withdraw Your claim with respect to the - Participant Software against such Participant either - unilaterally or pursuant to a written agreement with - Participant. - 6.3. In the event of termination under Sections 6.1 or 6.2 - above, all end user licenses that have been validly granted - by You or any distributor hereunder prior to termination - (excluding licenses granted to You by any distributor) - shall survive termination. - 7. LIMITATION OF LIABILITY. - UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER TORT - (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL YOU, THE - INITIAL DEVELOPER, ANY OTHER CONTRIBUTOR, OR ANY DISTRIBUTOR OF - COVERED SOFTWARE, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE - LIABLE TO ANY PERSON FOR ANY INDIRECT, SPECIAL, INCIDENTAL, OR - CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT - LIMITATION, DAMAGES FOR LOST PROFITS, LOSS OF GOODWILL, WORK - STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER - COMMERCIAL DAMAGES OR LOSSES, EVEN IF SUCH PARTY SHALL HAVE BEEN - INFORMED OF THE POSSIBILITY OF SUCH DAMAGES. THIS LIMITATION OF - LIABILITY SHALL NOT APPLY TO LIABILITY FOR DEATH OR PERSONAL - INJURY RESULTING FROM SUCH PARTY'S NEGLIGENCE TO THE EXTENT - APPLICABLE LAW PROHIBITS SUCH LIMITATION. SOME JURISDICTIONS DO - NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR - CONSEQUENTIAL DAMAGES, SO THIS EXCLUSION AND LIMITATION MAY NOT - APPLY TO YOU. - 8. U.S. GOVERNMENT END USERS. - The Covered Software is a "commercial item," as that term is - defined in 48 C.F.R. 2.101 (Oct. 1995), consisting of "commercial - computer software" (as that term is defined at 48 C.F.R. ¤ - 252.227-7014(a)(1)) and "commercial computer software - documentation" as such terms are used in 48 C.F.R. 12.212 (Sept. - 1995). Consistent with 48 C.F.R. 12.212 and 48 C.F.R. 227.7202-1 - through 227.7202-4 (June 1995), all U.S. Government End Users - acquire Covered Software with only those rights set forth herein. - This U.S. Government Rights clause is in lieu of, and supersedes, - any other FAR, DFAR, or other clause or provision that addresses - Government rights in computer software under this License. - 9. MISCELLANEOUS. - This License represents the complete agreement concerning subject - matter hereof. If any provision of this License is held to be - unenforceable, such provision shall be reformed only to the - extent necessary to make it enforceable. This License shall be - governed by the law of the jurisdiction specified in a notice - contained within the Original Software (except to the extent - applicable law, if any, provides otherwise), excluding such - jurisdiction's conflict-of-law provisions. Any litigation - relating to this License shall be subject to the jurisdiction of - the courts located in the jurisdiction and venue specified in a - notice contained within the Original Software, with the losing - party responsible for costs, including, without limitation, court - costs and reasonable attorneys' fees and expenses. The - application of the United Nations Convention on Contracts for the - International Sale of Goods is expressly excluded. Any law or - regulation which provides that the language of a contract shall - be construed against the drafter shall not apply to this License. - You agree that You alone are responsible for compliance with the - United States export administration regulations (and the export - control laws and regulation of any other countries) when You use, - distribute or otherwise make available any Covered Software. - 10. RESPONSIBILITY FOR CLAIMS. - As between Initial Developer and the Contributors, each party is - responsible for claims and damages arising, directly or - indirectly, out of its utilization of rights under this License - and You agree to work with Initial Developer and Contributors to - distribute such responsibility on an equitable basis. Nothing - herein is intended or shall be deemed to constitute any admission - of liability. - ------------------------------------------------------------------------------------- - MIT ------------------------------------------------------------------------------------- - -This product bundles jopt-simple 4.9, which is available under a "MIT Software License" license. For details, see http://jopt-simple.sourceforge.net -This product bundles jcodings 1.0.8, which is available under a "MIT Software License" license. For details, see https://github.com/jruby/jcodings -This product bundles joni 2.1.2, which is available under a "MIT Software License" license. For details, see https://github.com/jruby/joni -This product bundles slf4j-api 1.7.10, which is available under a "MIT Software License" license. For details, see http://www.slf4j.org -This product bundles slf4j-log4j12 1.7.10, which is available under a "MIT Software License" license. For details, see http://www.slf4j.org - - -Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: - -The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - ------------------------------------------------------------------------------------- - Public Domain ------------------------------------------------------------------------------------- - -This product contains the extensions to Java Collections Framework which has -been derived from the works by JSR-166 EG, Doug Lea, and Jason T. Greene: - - * LICENSE: - * license/LICENSE.jsr166y.txt (Public Domain) - * HOMEPAGE: - * http://gee.cs.oswego.edu/cgi-bin/viewcvs.cgi/jsr166/ - * http://viewvc.jboss.org/cgi-bin/viewvc.cgi/jbosscache/experimental/jsr166/ - -This product contains a modified version of Robert Harder's Public Domain -Base64 Encoder and Decoder, which can be obtained at: - - * LICENSE: - * license/LICENSE.base64.txt (Public Domain) - * HOMEPAGE: - * http://iharder.sourceforge.net/current/java/base64/ - - http://git-wip-us.apache.org/repos/asf/metron/blob/3d84ea42/metron-analytics/metron-profiler/src/main/resources/META-INF/NOTICE ---------------------------------------------------------------------- diff --git a/metron-analytics/metron-profiler/src/main/resources/META-INF/NOTICE b/metron-analytics/metron-profiler/src/main/resources/META-INF/NOTICE deleted file mode 100755 index 1c05f2d..0000000 --- a/metron-analytics/metron-profiler/src/main/resources/META-INF/NOTICE +++ /dev/null @@ -1,92 +0,0 @@ - -metron-profiler -Copyright 2006-2016 The Apache Software Foundation - -This product includes software developed at -The Apache Software Foundation (http://www.apache.org/). - -This project contains annotations derived from JCIP-ANNOTATIONS -Copyright (c) 2005 Brian Goetz and Tim Peierls. See http://www.jcip.net - -=============================================================================== - -The BracketFinder (package org.apache.commons.math3.optimization.univariate) -and PowellOptimizer (package org.apache.commons.math3.optimization.general) -classes are based on the Python code in module "optimize.py" (version 0.5) -developed by Travis E. Oliphant for the SciPy library (http://www.scipy.org/) -Copyright © 2003-2009 SciPy Developers. -=============================================================================== - -The LinearConstraint, LinearObjectiveFunction, LinearOptimizer, -RelationShip, SimplexSolver and SimplexTableau classes in package -org.apache.commons.math3.optimization.linear include software developed by -Benjamin McCann (http://www.benmccann.com) and distributed with -the following copyright: Copyright 2009 Google Inc. -=============================================================================== - -This product includes software developed by the -University of Chicago, as Operator of Argonne National -Laboratory. -The LevenbergMarquardtOptimizer class in package -org.apache.commons.math3.optimization.general includes software -translated from the lmder, lmpar and qrsolv Fortran routines -from the Minpack package -Minpack Copyright Notice (1999) University of Chicago. All rights reserved -=============================================================================== - -The GraggBulirschStoerIntegrator class in package -org.apache.commons.math3.ode.nonstiff includes software translated -from the odex Fortran routine developed by E. Hairer and G. Wanner. -Original source copyright: -Copyright (c) 2004, Ernst Hairer -=============================================================================== - -The EigenDecompositionImpl class in package -org.apache.commons.math3.linear includes software translated -from some LAPACK Fortran routines. Original source copyright: -Copyright (c) 1992-2008 The University of Tennessee. All rights reserved. -=============================================================================== - -The MersenneTwister class in package org.apache.commons.math3.random -includes software translated from the 2002-01-26 version of -the Mersenne-Twister generator written in C by Makoto Matsumoto and Takuji -Nishimura. Original source copyright: -Copyright (C) 1997 - 2002, Makoto Matsumoto and Takuji Nishimura, -All rights reserved -=============================================================================== - -The LocalizedFormatsTest class in the unit tests is an adapted version of -the OrekitMessagesTest class from the orekit library distributed under the -terms of the Apache 2 licence. Original source copyright: -Copyright 2010 CS Systèmes d'Information -=============================================================================== - -The HermiteInterpolator class and its corresponding test have been imported from -the orekit library distributed under the terms of the Apache 2 licence. Original -source copyright: -Copyright 2010-2012 CS Systèmes d'Information -=============================================================================== - -The creation of the package "o.a.c.m.analysis.integration.gauss" was inspired -by an original code donated by Sébastien Brisard. -=============================================================================== - -The complete text of licenses and disclaimers associated with the the original -sources enumerated above at the time of code translation are in the LICENSE.txt -file. - - The Netty Project - ================= - -Please visit the Netty web site for more information: - - * http://netty.io/ - -Copyright 2011 The Netty Project - -Google Guice - Core Library -Copyright 2006-2011 Google, Inc. - -Google Guice - Extensions - Servlet -Copyright 2006-2011 Google, Inc. -
