Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $
You can buy this project and download/modify it how often you want.
org.graylog2.rest.resources.search.KeywordSearchResource Maven / Gradle / Ivy
/**
* This file is part of Graylog.
*
* Graylog is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Graylog is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with Graylog. If not, see fieldList = parseOptionalFields(fields);
final Sorting sorting = buildSorting(sort);
final TimeRange timeRange = buildKeywordTimeRange(keyword);
final SearchesConfig searchesConfig = SearchesConfig.builder()
.query(query)
.filter(filter)
.fields(fieldList)
.range(timeRange)
.limit(limit)
.offset(offset)
.sorting(sorting)
.build();
try {
return buildSearchResponse(searches.search(searchesConfig), timeRange);
} catch (SearchPhaseExecutionException e) {
throw createRequestExceptionForParseFailure(query, e);
}
}
@GET
@Timed
@ApiOperation(value = "Message search with keyword as timerange.",
notes = "Search for messages in a timerange defined by a keyword like \"yesterday\" or \"2 weeks ago to wednesday\".")
@Produces(MoreMediaTypes.TEXT_CSV)
@ApiResponses(value = {
@ApiResponse(code = 400, message = "Invalid keyword provided.")
})
public ChunkedOutput searchKeywordChunked(
@ApiParam(name = "query", value = "Query (Lucene syntax)", required = true)
@QueryParam("query") @NotEmpty String query,
@ApiParam(name = "keyword", value = "Range keyword", required = true) @QueryParam("keyword") String keyword,
@ApiParam(name = "limit", value = "Maximum number of messages to return.", required = false) @QueryParam("limit") int limit,
@ApiParam(name = "offset", value = "Offset", required = false) @QueryParam("offset") int offset,
@ApiParam(name = "filter", value = "Filter", required = false) @QueryParam("filter") String filter,
@ApiParam(name = "fields", value = "Comma separated list of fields to return", required = true) @QueryParam("fields") String fields) {
checkSearchPermission(filter, RestPermissions.SEARCHES_KEYWORD);
final List fieldList = parseFields(fields);
final TimeRange timeRange = buildKeywordTimeRange(keyword);
try {
final ScrollResult scroll = searches
.scroll(query, timeRange, limit, offset, fieldList, filter);
return buildChunkedOutput(scroll, limit);
} catch (SearchPhaseExecutionException e) {
throw createRequestExceptionForParseFailure(query, e);
}
}
@GET
@Path("/export")
@Timed
@ApiOperation(value = "Export message search with keyword as timerange.",
notes = "Search for messages in a timerange defined by a keyword like \"yesterday\" or \"2 weeks ago to wednesday\".")
@Produces(MoreMediaTypes.TEXT_CSV)
@ApiResponses(value = {
@ApiResponse(code = 400, message = "Invalid keyword provided.")
})
public Response exportSearchKeywordChunked(
@ApiParam(name = "query", value = "Query (Lucene syntax)", required = true)
@QueryParam("query") @NotEmpty String query,
@ApiParam(name = "keyword", value = "Range keyword", required = true) @QueryParam("keyword") String keyword,
@ApiParam(name = "limit", value = "Maximum number of messages to return.", required = false) @QueryParam("limit") int limit,
@ApiParam(name = "offset", value = "Offset", required = false) @QueryParam("offset") int offset,
@ApiParam(name = "filter", value = "Filter", required = false) @QueryParam("filter") String filter,
@ApiParam(name = "fields", value = "Comma separated list of fields to return", required = true) @QueryParam("fields") String fields) {
checkSearchPermission(filter, RestPermissions.SEARCHES_KEYWORD);
final String filename = "graylog-search-result-keyword-" + keyword + ".csv";
return Response
.ok(searchKeywordChunked(query, keyword, limit, offset, filter, fields))
.header("Content-Disposition", "attachment; filename=" + filename)
.build();
}
@GET
@Path("/histogram")
@Timed
@ApiOperation(value = "Datetime histogram of a query using keyword timerange.")
@ApiResponses(value = {
@ApiResponse(code = 400, message = "Invalid timerange parameters provided."),
@ApiResponse(code = 400, message = "Invalid interval provided.")
})
@Produces(MediaType.APPLICATION_JSON)
public HistogramResult histogramKeyword(
@ApiParam(name = "query", value = "Query (Lucene syntax)", required = true)
@QueryParam("query") @NotEmpty String query,
@ApiParam(name = "interval", value = "Histogram interval / bucket size. (year, quarter, month, week, day, hour or minute)", required = true)
@QueryParam("interval") @NotEmpty String interval,
@ApiParam(name = "keyword", value = "Range keyword", required = true) @QueryParam("keyword") String keyword,
@ApiParam(name = "filter", value = "Filter", required = false) @QueryParam("filter") String filter) {
checkSearchPermission(filter, RestPermissions.SEARCHES_KEYWORD);
interval = interval.toUpperCase(Locale.ENGLISH);
validateInterval(interval);
try {
return buildHistogramResult(
searches.histogram(
query,
Searches.DateHistogramInterval.valueOf(interval),
filter,
buildKeywordTimeRange(keyword)
)
);
} catch (SearchPhaseExecutionException e) {
throw createRequestExceptionForParseFailure(query, e);
}
}
@GET
@Path("/terms")
@Timed
@ApiOperation(value = "Most common field terms of a query using a keyword timerange.")
@ApiResponses(value = {
@ApiResponse(code = 400, message = "Invalid timerange parameters provided.")
})
@Produces(MediaType.APPLICATION_JSON)
public TermsResult termsKeyword(
@ApiParam(name = "field", value = "Message field of to return terms of", required = true)
@QueryParam("field") @NotEmpty String field,
@ApiParam(name = "query", value = "Query (Lucene syntax)", required = true)
@QueryParam("query") @NotEmpty String query,
@ApiParam(name = "size", value = "Maximum number of terms to return", required = false) @QueryParam("size") int size,
@ApiParam(name = "keyword", value = "Range keyword", required = true) @QueryParam("keyword") String keyword,
@ApiParam(name = "filter", value = "Filter", required = false) @QueryParam("filter") String filter) {
checkSearchPermission(filter, RestPermissions.SEARCHES_KEYWORD);
try {
return buildTermsResult(searches.terms(field, size, query, filter, buildKeywordTimeRange(keyword)));
} catch (SearchPhaseExecutionException e) {
throw createRequestExceptionForParseFailure(query, e);
}
}
@GET
@Path("/termsstats")
@Timed
@ApiOperation(value = "Ordered field terms of a query computed on another field using a keyword timerange.")
@ApiResponses(value = {
@ApiResponse(code = 400, message = "Invalid timerange parameters provided.")
})
@Produces(MediaType.APPLICATION_JSON)
public TermsStatsResult termsStatsRelative(
@ApiParam(name = "key_field", value = "Message field of to return terms of", required = true)
@QueryParam("key_field") @NotEmpty String keyField,
@ApiParam(name = "value_field", value = "Value field used for computation", required = true)
@QueryParam("value_field") @NotEmpty String valueField,
@ApiParam(name = "order", value = "What to order on (Allowed values: TERM, REVERSE_TERM, COUNT, REVERSE_COUNT, TOTAL, REVERSE_TOTAL, MIN, REVERSE_MIN, MAX, REVERSE_MAX, MEAN, REVERSE_MEAN)", required = true)
@QueryParam("order") @NotEmpty String order,
@ApiParam(name = "query", value = "Query (Lucene syntax)", required = true)
@QueryParam("query") @NotEmpty String query,
@ApiParam(name = "size", value = "Maximum number of terms to return", required = false) @QueryParam("size") int size,
@ApiParam(name = "keyword", value = "Keyword timeframe", required = true) @QueryParam("keyword") String keyword,
@ApiParam(name = "filter", value = "Filter", required = false) @QueryParam("filter") String filter) {
checkSearchPermission(filter, RestPermissions.SEARCHES_KEYWORD);
try {
return buildTermsStatsResult(
searches.termsStats(keyField, valueField, Searches.TermsStatsOrder.valueOf(order.toUpperCase(Locale.ENGLISH)), size, query, filter, buildKeywordTimeRange(keyword))
);
} catch (SearchPhaseExecutionException e) {
throw createRequestExceptionForParseFailure(query, e);
}
}
@GET
@Path("/stats")
@Timed
@ApiOperation(value = "Field statistics for a query using a keyword timerange.",
notes = "Returns statistics like min/max or standard deviation of numeric fields " +
"over the whole query result set.")
@Produces(MediaType.APPLICATION_JSON)
@ApiResponses(value = {
@ApiResponse(code = 400, message = "Invalid timerange parameters provided."),
@ApiResponse(code = 400, message = "Field is not of numeric type.")
})
public FieldStatsResult statsKeyword(
@ApiParam(name = "field", value = "Message field of numeric type to return statistics for", required = true)
@QueryParam("field") @NotEmpty String field,
@ApiParam(name = "query", value = "Query (Lucene syntax)", required = true)
@QueryParam("query") @NotEmpty String query,
@ApiParam(name = "keyword", value = "Range keyword", required = true) @QueryParam("keyword") String keyword,
@ApiParam(name = "filter", value = "Filter", required = false) @QueryParam("filter") String filter) {
checkSearchPermission(filter, RestPermissions.SEARCHES_KEYWORD);
try {
return buildFieldStatsResult(fieldStats(field, query, filter, buildKeywordTimeRange(keyword)));
} catch (SearchPhaseExecutionException e) {
throw createRequestExceptionForParseFailure(query, e);
}
}
@GET
@Path("/fieldhistogram")
@Timed
@ApiOperation(value = "Datetime histogram of a query using keyword timerange.")
@ApiResponses(value = {
@ApiResponse(code = 400, message = "Invalid timerange parameters provided."),
@ApiResponse(code = 400, message = "Invalid interval provided."),
@ApiResponse(code = 400, message = "Field is not of numeric type.")
})
@Produces(MediaType.APPLICATION_JSON)
public HistogramResult fieldHistogramKeyword(
@ApiParam(name = "query", value = "Query (Lucene syntax)", required = true)
@QueryParam("query") @NotEmpty String query,
@ApiParam(name = "field", value = "Field of whose values to get the histogram of", required = true)
@QueryParam("field") @NotEmpty String field,
@ApiParam(name = "interval", value = "Histogram interval / bucket size. (year, quarter, month, week, day, hour or minute)", required = true)
@QueryParam("interval") @NotEmpty String interval,
@ApiParam(name = "keyword", value = "Range keyword", required = true) @QueryParam("keyword") String keyword,
@ApiParam(name = "filter", value = "Filter", required = false) @QueryParam("filter") String filter,
@ApiParam(name = "cardinality", value = "Calculate the cardinality of the field as well", required = false) @QueryParam("cardinality") boolean includeCardinality
) {
checkSearchPermission(filter, RestPermissions.SEARCHES_KEYWORD);
interval = interval.toUpperCase(Locale.ENGLISH);
validateInterval(interval);
try {
return buildHistogramResult(fieldHistogram(field, query, interval, filter, buildKeywordTimeRange(keyword),
includeCardinality));
} catch (SearchPhaseExecutionException e) {
throw createRequestExceptionForParseFailure(query, e);
}
}
private TimeRange buildKeywordTimeRange(String keyword) {
try {
return restrictTimeRange(KeywordRange.create(keyword));
} catch (InvalidRangeParametersException e) {
LOG.warn("Invalid timerange parameters provided. Returning HTTP 400.");
throw new BadRequestException("Invalid timerange parameters provided", e);
}
}
}
